パッケージ 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
    • 必須定数のサマリー

      必須要素  
      修飾子と型 必須要素 説明
      StringSEname
      (必須)テーブルの名前。
    • オプション要素のサマリー

      オプション要素  
      修飾子と型 オプションの要素 説明
      StringSEcatalog
      (オプション)テーブルのカタログ。
      ForeignKeyforeignKey
      (オプション)テーブル生成が有効な場合に、pkJoinColumns 要素に対応する列の外部キー制約の生成を指定または制御するために使用されます。
      Index[]indexes
      (オプション)テーブルのインデックス。
      PrimaryKeyJoinColumn[]pkJoinColumns
      (オプション)主テーブルとの結合に使用される列。
      StringSEschema
      (オプション)テーブルのスキーマ。
      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
        デフォルト:
        {}