ALTER TABLEGROUP

説明

このステートメントは、テーブルグループに複数のテーブルを追加し、テーブルグループの属性を変更するために使用します。

権限要件

ALTER TABLEGROUP ステートメントを実行するには、現在のユーザーが ALTER 権限を持っている必要があります。OceanBaseデータベースの権限の詳細については、Oracleモードの権限分類を参照してください。

使用上の制限と注意事項

• OceanBaseデータベースのアップグレード中は、テーブルグループの属性を変更することは禁止されています。

• V4.4.2バージョンでは、V4.4.2 BP1バージョンから、テーブルグループ内のパーティションの配置方法は SHARDING と SCOPE によって共同で決定されます。現在のバージョンでは SHARDING プロパティと SCOPE プロパティの一部の組み合わせのみがサポートされており、サポートされていない組み合わせを指定するとエラーが発生します。サポートされている組み合わせは以下の通りです：

  • SHARDING = 'NONE' + SCOPE = 'SERVER'
  • SHARDING = 'NONE' + SCOPE = 'ZONE'
  • SHARDING = 'NONE' + SCOPE = 'CLUSTER'
  • SHARDING = 'PARTITION' + SCOPE = 'CLUSTER'
  • SHARDING = 'ADAPTIVE' + SCOPE = 'CLUSTER'

構文

ALTER TABLEGROUP tablegroup_name
    {ADD [TABLE] table_name_list
    | [sharding_option,] [scope_option]
    };

table_name_list:
    table_name [, table_name ...]

sharding_option:
    SHARDING = '{NONE | PARTITION | ADAPTIVE}'

scope_option:
    SCOPE = '{SERVER | ZONE | CLUSTER}'

パラメータ説明

sharding_option

• NONE：テーブルグループに追加するテーブルに制限がないことを示します。
• PARTITION：テーブルグループに追加するテーブルに対応するパーティションのパーティション分割方式が、テーブルグループ内のすべてのテーブルのパーティション分割方式と一致する必要があることを示します。これには、パーティションタイプ、パーティション数、パーティション値が含まれます。
• ADAPTIVE：テーブルグループに追加するテーブルに対応するパーティションとサブパーティションのパーティション分割方式が、テーブルグループ内のすべてのテーブルのパーティションとサブパーティションのパーティション分割方式と一致する必要があることを示します。これには、パーティションタイプ、パーティション数、パーティション値が含まれます。テーブルグループに追加するテーブルは、同一の種類のパーティションテーブル（パーティションテーブルまたはサブパーティションテーブル）でなければなりません。

同じパーティション分割方式には以下が含まれます：

• パーティションタイプが同じであること（例：どちらもHash + Rangeパーティション）。
• Hashパーティションの場合、参照する列数とパーティション数が同じであること。
• Rangeパーティションの場合、参照する列数とパーティション数が同じであり、Rangeの分割ポイントが同じであること。

サブパーティションについても、そのパーティションタイプに応じて、上記の要件が適用されます。

scope_option

• SERVER：すべてのPartition GroupのLeaderが同一ノードに集約されていることを示します。
• ZONE：すべてのPartition GroupのLeaderが同一Zone内に分散して配置されていることを示します。
• CLUSTER：すべてのPartition GroupのLeaderがクラスタ内の各ノードに分散して配置されていることを示します。

例

• tblgroup1 という名前のテーブルグループを作成し、その SHARDING 属性を NONE に設定します。そして、パーティションテーブル tbl1 とパーティションテーブル tbl2 をこのテーブルグループに追加します。

  obclient> CREATE TABLEGROUP tblgroup1 SHARDING = 'NONE';
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl1(col1 NUMBER,col2 VARCHAR2(50))
      PARTITION BY LIST(col1) SUBPARTITION BY LIST (col2)
        SUBPARTITION TEMPLATE
        (SUBPARTITION mp0 VALUES ('01'),
         SUBPARTITION mp1 VALUES ('02'),
         SUBPARTITION mp2 VALUES ('03')
         )
        (PARTITION p0 VALUES('01'),
         PARTITION p1 VALUES('02')
        );
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl2(col1 NUMBER,col2 VARCHAR2(50)) TABLEGROUP = tblgroup1
      PARTITION BY LIST(col1) SUBPARTITION BY LIST(col2)
        SUBPARTITION TEMPLATE
        (SUBPARTITION mp0 VALUES('01'),
         SUBPARTITION mp1 VALUES('02'),
         SUBPARTITION mp2 VALUES('03')
        )
        (PARTITION p0 VALUES('01'),
         PARTITION p1 VALUES('02')
        );
  Query OK, 0 rows affected
  
  obclient> ALTER TABLEGROUP tblgroup1 ADD tbl1,tbl2;
  Query OK, 0 rows affected
  

  tbl1 と tbl2 のパーティショニング方法が同じであるため、SHARDING 属性を PARTITION または ADAPTIVE に変更できます。

  obclient> ALTER TABLEGROUP tblgroup1 SHARDING = 'PARTITION';
  Query OK, 0 rows affected
  
  obclient> ALTER TABLEGROUP tblgroup1 SHARDING = 'ADAPTIVE';
  Query OK, 0 rows affected
  

• tblgroup2 という名前のテーブルグループを作成し、その SHARDING 属性を NONE に設定します。非パーティションテーブル tbl1 とパーティションテーブル tbl2 をこのテーブルグループに追加します。

  obclient> CREATE TABLEGROUP tblgroup2 SHARDING = 'NONE';
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl1 (col INT);
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl2(col1 NUMBER,col2 VARCHAR2(50)) TABLEGROUP = tblgroup2
      PARTITION BY LIST(col1) SUBPARTITION BY LIST(col2)
        SUBPARTITION TEMPLATE
        (SUBPARTITION mp0 VALUES('01'),
         SUBPARTITION mp1 VALUES('02'),
         SUBPARTITION mp2 VALUES('03')
        )
        (PARTITION p0 VALUES('01'),
         PARTITION p1 VALUES('02')
        );
  Query OK, 0 rows affected
  
  obclient> ALTER TABLEGROUP tblgroup2 ADD tbl1,tbl2;
  Query OK, 0 rows affected
  

  テーブルグループ tblgroup2 には非パーティションテーブルとパーティションテーブルが含まれているため、SHARDING 属性を PARTITION または ADAPTIVE に変更することはできません。

  obclient> ALTER TABLEGROUP tblgroup2 SHARDING = 'PARTITION';
  OBE-00600: internal error code, arguments: -4179, not all tables are non-partitioned or partitioned, modify tablegroup sharding attribute not allowed
  
  obclient> ALTER TABLEGROUP tblgroup2 SHARDING = 'ADAPTIVE';
  OBE-00600: internal error code, arguments: -4179, not all tables are non-partitioned or partitioned, modify tablegroup sharding attribute not allowed
  

• tblgroup3 という名前のテーブルグループを作成し、その SHARDING 属性を NONE に設定します。パーティションテーブル tbl1 とパーティションテーブル tbl2 をこのテーブルグループに追加します。

  obclient> CREATE TABLEGROUP tblgroup3 SHARDING = 'NONE';
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl1(col1 NUMBER,col2 VARCHAR2(50))
     PARTITION BY LIST(col1) SUBPARTITION BY LIST (col2)
       SUBPARTITION TEMPLATE
       (SUBPARTITION mp0 VALUES ('01'),
        SUBPARTITION mp1 VALUES ('02')
        )
       (PARTITION p0 VALUES('01'),
        PARTITION p1 VALUES('02')
       );
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl2(col1 NUMBER,col2 VARCHAR2(50))
     PARTITION BY LIST(col1) SUBPARTITION BY LIST(col2)
       SUBPARTITION TEMPLATE
       (SUBPARTITION mp0 VALUES('01'),
        SUBPARTITION mp1 VALUES('02'),
        SUBPARTITION mp2 VALUES('03')
       )
       (PARTITION p0 VALUES('01'),
        PARTITION p1 VALUES('02')
       );
  Query OK, 0 rows affected
  
  obclient> ALTER TABLEGROUP tblgroup3 ADD tbl1,tbl2;
  Query OK, 0 rows affected
  

  テーブルグループ tblgroup3 内の tbl1 と tbl2 のパーティションタイプは同じですが、サブパーティションのタイプが異なります（サブパーティションの数が異なる）。そのため、SHARDING 属性を PARTITION に変更できますが、ADAPTIVE には変更できません。

  obclient> ALTER TABLEGROUP tblgroup3 SHARDING = 'PARTITION';
  Query OK, 0 rows affected
  
  obclient> ALTER TABLEGROUP tblgroup3 SHARDING = 'ADAPTIVE';
  OBE-00600: internal error code, arguments: -4179, subpartition num not matched, modify tablegroup sharding attribute not allowed
  

• tblgroup4 という名前のテーブルグループを作成し、その SHARDING 属性を ADAPTIVE に設定します。このテーブルグループ内のテーブル tbl1 とテーブル tbl2 のパーティション数を変更すると、テーブルグループ内のすべてのテーブルのパーティショニング方法が一致しなくなります。そのため、新しいテーブル tbl3 をこのテーブルグループに追加することはできません。

  obclient> CREATE TABLEGROUP tblgroup4 SHARDING = 'ADAPTIVE';
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl1(col1 int,col2 int)
      PARTITION BY RANGE(col1) SUBPARTITION BY RANGE(col2)
        SUBPARTITION TEMPLATE
          (SUBPARTITION mp0 VALUES LESS THAN(2021),
           SUBPARTITION mp1 VALUES LESS THAN(2022),
           SUBPARTITION mp2 VALUES LESS THAN(2023)
          )
          (PARTITION p0 VALUES LESS THAN(100),
           PARTITION p1 VALUES LESS THAN(200)
          );
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl2(col1 int,col2 int)
      PARTITION BY RANGE(col1) SUBPARTITION BY RANGE(col2)
        SUBPARTITION TEMPLATE
         (SUBPARTITION mp0 VALUES LESS THAN(2021),
          SUBPARTITION mp1 VALUES LESS THAN(2022),
          SUBPARTITION mp2 VALUES LESS THAN(2023)
         )
        (PARTITION p0 VALUES LESS THAN(100),
         PARTITION p1 VALUES LESS THAN(200)
        );
  Query OK, 0 rows affected
  
  obclient> ALTER TABLEGROUP tblgroup4 ADD tbl1,tbl2;
  Query OK, 0 rows affected
  
  obclient> ALTER TABLE tbl1 ADD PARTITION p3 VALUES LESS THAN(400), PARTITION p4 VALUES LESS THAN(500);
  Query OK, 0 rows affected
  
  obclient> ALTER TABLE tbl2 DROP SUBPARTITION p0smp0,p0smp1;
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl3(col1 int,col2 int)
      PARTITION BY RANGE(col1) SUBPARTITION BY RANGE(col2)
        SUBPARTITION TEMPLATE
       (SUBPARTITION mp0 VALUES LESS THAN(2021),
        SUBPARTITION mp1 VALUES LESS THAN(2022),
        SUBPARTITION mp2 VALUES LESS THAN(2023)
       )
       (PARTITION p0 VALUES LESS THAN(100),
        PARTITION p1 VALUES LESS THAN(200)
        );
  Query OK, 0 rows affected
  
  obclient> ALTER TABLEGROUP tblgroup4 ADD tbl3;
  OBE-00600: internal error code, arguments: -4179, partition num not equal, add table to tablegroup not allowed
  

関連ドキュメント

• CREATE TABLEGROUP

• DROP TABLEGROUP

• テーブルグループ内のテーブルの管理

• テーブルグループ情報の確認