ALTER TABLEGROUP

説明

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

権限要件

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

構文

• テーブルグループに複数のテーブルを追加します。

  ALTER TABLEGROUP tablegroup_name ADD [TABLE] table_name [, table_name...];
  

• テーブルグループのパーティションルールを変更します。

  ALTER TABLEGROUP tablegroup_name tablegroup_option;
  
  tablegroup_option:
      SHARDING = 'NONE' | 'PARTITION' | 'ADAPTIVE'
  

パラメータの説明

例

• 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

• テーブルグループ内のテーブルを管理する

• テーブルグループ情報を確認する