Difference between revisions of "EclipseLink/UserGuide/JPA/Advanced JPA Development/Schema Generation/Appending strings to CREATE TABLE statements"

From Eclipsepedia

Jump to: navigation, search
m
(9 intermediate revisions by 2 users not shown)
Line 13: Line 13:
 
= Appending Strings to CREATE TABLE Statements  =
 
= Appending Strings to CREATE TABLE Statements  =
  
 +
You can append a string to the end of a CREATE TABLE statement when generating a DDL. This can be useful, for example, to create tables that are transactional, by appending <tt>engine=InnoDB</tt> to the end of the creation statement to specify that the MySQL InnoDB storage engine will be used.
 +
 +
Appending the string only affects the DDL generation. It does not affect any other runtime behavior.
 +
 +
You can specify strings using persistence unit properties or session properties to apply to every table in that context. Specify strings in <tt>eclipselink-orm.xml</tt> to apply to individual tables.
 +
 +
== Persistence Unit Properties ==
 +
 +
For a persistence unit, use the property <tt>eclipselink.ddl-generation.table-creation-suffix</tt> to append a string to all tables defined in the persistence unit.
 +
 +
== eclipselink-orm.xml ==
 +
 +
For individual tables, use the <tt>creation-suffix</tt> attribute for table creation elements in <tt>eclipelink-orm.xml</tt>. This following elements can take this attribute:
 +
 +
* table
 +
* secondary-table
 +
* join-table
 +
* collection-table
 +
* table-generator
 +
 +
== Annotations ==
 +
 +
This feature is not currently supported through annotations.
  
>>>>>> THIS PAGE IS IN PROGRESS. PLEASE SEE DISCUSSION PAGE. <<<<<<
 
 
===Example===
 
===Example===
 
Assuming it has an ID annotated, an <tt>eclipselink-orm.xml</tt> file containing...
 
Assuming it has an ID annotated, an <tt>eclipselink-orm.xml</tt> file containing...
Line 38: Line 60:
 
|previous =[[EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Schema_Generation/CascadeOnDelete|@CascadeOnDelete]]
 
|previous =[[EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Schema_Generation/CascadeOnDelete|@CascadeOnDelete]]
 
|up      =[[EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Schema_Generation|Schema Generation]]
 
|up      =[[EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Schema_Generation|Schema Generation]]
|next =[[EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Schema_Generation/Index|@Index]]
+
|next=[[EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Data Partitioning|Data Partitioning]]
 
|version=2.2.0 DRAFT}}
 
|version=2.2.0 DRAFT}}

Revision as of 10:53, 16 June 2011

EclipseLink JPA

link="http://wiki.eclipse.org/EclipseLink"
EclipseLink
Website
Download
Community
Mailing ListForumsIRC
Bugzilla
Open
Help Wanted
Bug Day
Contribute
Browse Source


Appending Strings to CREATE TABLE Statements

You can append a string to the end of a CREATE TABLE statement when generating a DDL. This can be useful, for example, to create tables that are transactional, by appending engine=InnoDB to the end of the creation statement to specify that the MySQL InnoDB storage engine will be used.

Appending the string only affects the DDL generation. It does not affect any other runtime behavior.

You can specify strings using persistence unit properties or session properties to apply to every table in that context. Specify strings in eclipselink-orm.xml to apply to individual tables.

Persistence Unit Properties

For a persistence unit, use the property eclipselink.ddl-generation.table-creation-suffix to append a string to all tables defined in the persistence unit.

eclipselink-orm.xml

For individual tables, use the creation-suffix attribute for table creation elements in eclipelink-orm.xml. This following elements can take this attribute:

  • table
  • secondary-table
  • join-table
  • collection-table
  • table-generator

Annotations

This feature is not currently supported through annotations.

Example

Assuming it has an ID annotated, an eclipselink-orm.xml file containing...

<entity class="Comment">
  <table name="DDL_COMMENT" creation-suffix="COMMENT='User Comment Table'"/>
</entity>

...results in the following creation statement:

  CREATE TABLE DDL_COMMENT (ID INTEGER) COMMENT='User Comment Table'

If it is coupled with the following persistence property...

<property name="eclipselink.ddl.default-table-suffix" value="engine=InnoDB"/>

it results in the following creation statement:

  CREATE TABLE DDL_COMMENT (ID INTEGER) COMMENT='User Comment Table' engine=InnoDB

Eclipselink-logo.gif
Version: 2.2.0 DRAFT
Other versions...