パッケージ jakarta.persistence
アノテーション型 SecondaryTable
@RepeatableSE(SecondaryTables.class) @TargetSE(TYPESE) @RetentionSE(RUNTIMESE) public @interface SecondaryTable
アノテーション付きエンティティクラスのセカンダリテーブルを指定します。1 つ以上のセカンダリテーブルを指定すると、エンティティクラスのデータが複数のテーブルに保存されます。SecondaryTable
アノテーションが指定されていない場合、エンティティのすべての永続フィールドまたはプロパティがプライマリテーブルにマップされていると想定されます。主キー結合列が指定されていない場合、結合列は、主テーブルの主キー列を参照し、主テーブルの参照される主キー列と同じ名前と型を持つと想定されます。Example 1: Single secondary table with a single primary key column. @Entity @Table(name="CUSTOMER") @SecondaryTable(name="CUST_DETAIL", pkJoinColumns=@PrimaryKeyJoinColumn(name="CUST_ID")) public class Customer { ... } Example 2: Single secondary table with multiple primary key columns. @Entity @Table(name="CUSTOMER") @SecondaryTable(name="CUST_DETAIL", pkJoinColumns={ @PrimaryKeyJoinColumn(name="CUST_ID"), @PrimaryKeyJoinColumn(name="CUST_TYPE")}) public class Customer { ... }
- 導入:
- 1.0
オプション要素のサマリー
オプション要素 修飾子と型 オプションの要素 説明 StringSE
catalog
(オプション)テーブルのカタログ。ForeignKey
foreignKey
(オプション)テーブル生成が有効な場合に、pkJoinColumns
要素に対応する列の外部キー制約の生成を指定または制御するために使用されます。Index[]
indexes
(オプション)テーブルのインデックス。PrimaryKeyJoinColumn[]
pkJoinColumns
(オプション)主テーブルとの結合に使用される列。StringSE
schema
(オプション)テーブルのスキーマ。UniqueConstraint[]
uniqueConstraints
(オプション)テーブルに配置される一意の制約。
要素の詳細
name
StringSE name
(必須)テーブルの名前。
catalog
StringSE catalog
(オプション)テーブルのカタログ。デフォルトはデフォルトカタログです。
- デフォルト:
- ""
schema
StringSE schema
(オプション)テーブルのスキーマ。デフォルトはユーザーのデフォルトスキーマです。
- デフォルト:
- ""
pkJoinColumns
PrimaryKeyJoinColumn[] pkJoinColumns
(オプション)主テーブルとの結合に使用される列。デフォルトは、主テーブルの主キー列と同じ名前の列です。
- デフォルト:
- {}
foreignKey
ForeignKey foreignKey
(オプション)テーブル生成が有効な場合に、pkJoinColumns
要素に対応する列の外部キー制約の生成を指定または制御するために使用されます。この要素といずれかのpkJoinColumns
要素のforeignKey
要素の両方が指定されている場合、動作は未定義です。どちらの場所でも外部キーアノテーション要素が指定されていない場合は、永続性プロバイダーのデフォルトの外部キー戦略が適用されます。- 導入:
- 2.1
- デフォルト:
- @jakarta.persistence.ForeignKey(jakarta.persistence.ConstraintMode.PROVIDER_DEFAULT)
uniqueConstraints
UniqueConstraint[] uniqueConstraints
(オプション)テーブルに配置される一意の制約。これらは通常、テーブル生成が有効な場合にのみ使用されます。これらの制約は、Column
およびJoinColumn
アノテーションで指定された制約と、主キーマッピングで必要とされる制約に加えて適用されます。デフォルトでは追加の制約はありません。
- デフォルト:
- {}
indexes
Index[] indexes
(オプション)テーブルのインデックス。これらは、テーブル生成が有効な場合にのみ使用されます。- 導入:
- 2.1
- デフォルト:
- {}