CREATE TABLEGROUP

説明

このステートメントは、テーブルグループを作成するために使用されます。

テーブルグループは主に、同じ分散特性を持つテーブルのセットを作成するために使用されます。同じ分散特性を持つテーブルは結合操作を実行する際にローカルで処理できるため、ノード間のデータリクエストを回避できます。

テーブルグループを作成するには、現在のユーザーがグローバルな CREATE (*.*) 権限を持っている必要があります。

構文

CREATE TABLEGROUP tablegroup_name [tablegroup_option];

tablegroup_option:
   SHARDING = 'NONE' | 'PARTITION' | 'ADAPTIVE'

パラメータの説明

例

• myTableGroup1 という名前のテーブルグループを作成し、非パーティションテーブル myt1 と myt2 をこのグループに追加します。

  obclient> CREATE TABLEGROUP myTableGroup1;
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE myt1 (c1 INT, c2 INT ) TABLEGROUP = myTableGroup1;
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE myt2 (c1 INT, c2 INT ) TABLEGROUP = myTableGroup1;
  Query OK, 0 rows affected
  

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

  obclient> CREATE TABLEGROUP tblgroup1 SHARDING = 'NONE';
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl1 (col INT) TABLEGROUP = tblgroup1;
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl2 (col1 BIGINT PRIMARY KEY,col2 VARCHAR(50)) TABLEGROUP = tblgroup1
      PARTITION BY LIST(col1)
        (PARTITION p0 VALUES IN (1, 2, 3),
         PARTITION p1 VALUES IN (5, 6),
         PARTITION p2 VALUES IN (DEFAULT)
         );
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl3(col1 INT,col2 varchar(50)) TABLEGROUP = tblgroup1
      PARTITION BY LIST(col1) SUBPARTITION BY LIST COLUMNS(col2)
     (PARTITION p0 VALUES in (01)
        (SUBPARTITION mp0 VALUES in ('01'),
         SUBPARTITION mp1 VALUES in ('02'),
         SUBPARTITION mp2 VALUES in ('03')),
      PARTITION p1 VALUES in (02)
        (SUBPARTITION mp3 VALUES in ('01'),
         SUBPARTITION mp4 VALUES in ('02'),
         SUBPARTITION mp5 VALUES in ('03'))
       );
  Query OK, 0 rows affected
  

• tblgroup2 という名前のテーブルグループを作成し、その SHARDING プロパティを PARTITION に設定します。パーティションテーブル tbl1 とパーティションテーブル tbl2 をこのグループに追加します。両者のパーティショニング方法は同じです。

  obclient> CREATE TABLEGROUP tblgroup2 SHARDING = 'PARTITION';
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl1 (col1 BIGINT PRIMARY KEY,col2 VARCHAR(50)) TABLEGROUP = tblgroup2
      PARTITION BY LIST(col1)
        (PARTITION p0 VALUES IN (1, 2, 3),
         PARTITION p1 VALUES IN (5, 6),
         PARTITION p2 VALUES IN (DEFAULT)
        );
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl2 (col1 BIGINT PRIMARY KEY,col2 VARCHAR(50)) TABLEGROUP = tblgroup2
    PARTITION BY LIST(col1)
      (PARTITION p0 VALUES IN (1, 2, 3),
       PARTITION p1 VALUES IN (5, 6),
       PARTITION p2 VALUES IN (DEFAULT)
       );
  Query OK, 0 rows affected
  

• tblgroup3 という名前のテーブルグループを作成し、その SHARDING プロパティを PARTITION に設定します。非パーティションテーブル tbl1 とパーティションテーブル tbl2 を同時にこのグループに追加することはできません。

  obclient> CREATE TABLEGROUP tblgroup3 SHARDING = 'PARTITION';
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl1 (col INT) TABLEGROUP = tblgroup3;
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl2 (col1 BIGINT PRIMARY KEY,col2 VARCHAR(50)) TABLEGROUP = tblgroup3
      PARTITION BY LIST(col1)
        (PARTITION p0 VALUES IN (1, 2, 3),
         PARTITION p1 VALUES IN (5, 6),
         PARTITION p2 VALUES IN (DEFAULT)
         );
  ERROR 4179 (HY000): not all tables are non-partitioned or partitioned, add table to tablegroup not allowed
  

• tblgroup4 という名前のテーブルグループを作成し、その SHARDING プロパティを PARTITION に設定します。パーティションテーブル tbl1 とパーティションテーブル tbl2 のパーティション値が異なるため、同時にこのグループに追加することはできません。

  obclient> CREATE TABLEGROUP tblgroup4 SHARDING = 'PARTITION';
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl1 (col1 BIGINT PRIMARY KEY,col2 VARCHAR(50)) TABLEGROUP = tblgroup4
      PARTITION BY LIST(col1)
        (PARTITION p0 VALUES IN (1, 2, 3),
         PARTITION p1 VALUES IN (5, 6),
         PARTITION p2 VALUES IN (DEFAULT)
         );
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl2 (col1 BIGINT PRIMARY KEY,col2 VARCHAR(50)) TABLEGROUP = tblgroup4
      PARTITION BY LIST(col1)
        (PARTITION p0 VALUES IN (1, 2, 3),
         PARTITION p1 VALUES IN (5, 7),
         PARTITION p2 VALUES IN (DEFAULT)
         );
  ERROR 4179 (HY000): list_part partition value not equal, add table to tablegroup not allowed
  

• tblgroup5 という名前のテーブルグループを作成し、その SHARDING プロパティを ADAPTIVE に設定します。パーティションテーブル tbl1 とパーティションテーブル tbl2 をこのグループに追加します。両者のパーティショニング方法は同じです。

  obclient> CREATE TABLEGROUP tblgroup5 SHARDING = 'ADAPTIVE';
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl1(col1 INT,col2 VARCHAR(50)) TABLEGROUP = tblgroup5
      PARTITION BY LIST(col1) SUBPARTITION BY LIST COLUMNS(col2)
        (PARTITION p0 VALUES in (01)
           (SUBPARTITION mp0 VALUES in ('01'),
            SUBPARTITION mp1 VALUES in ('02'),
            SUBPARTITION mp2 VALUES in ('03')),
         PARTITION p1 VALUES in (02)
           (SUBPARTITION mp3 VALUES in ('01'),
            SUBPARTITION mp4 VALUES in ('02'),
            SUBPARTITION mp5 VALUES in ('03'))
        );
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl2(col1 INT,col2 VARCHAR(50)) TABLEGROUP = tblgroup5
      PARTITION BY LIST(col1) SUBPARTITION BY LIST COLUMNS(col2)
        (PARTITION p0 VALUES in (01)
           (SUBPARTITION mp0 VALUES in ('01'),
            SUBPARTITION mp1 VALUES in ('02'),
            SUBPARTITION mp2 VALUES in ('03')),
         PARTITION p1 VALUES in (02)
           (SUBPARTITION mp3 VALUES in ('01'),
            SUBPARTITION mp4 VALUES in ('02'),
            SUBPARTITION mp5 VALUES in ('03'))
         );
  Query OK, 0 rows affected
  

• tblgroup6 という名前のテーブルグループを作成し、その SHARDING プロパティを ADAPTIVE に設定します。非パーティションテーブル tbl1 とパーティションテーブル tbl2 を同時にこのグループに追加することはできません。

  obclient> CREATE TABLEGROUP tblgroup6 SHARDING = 'ADAPTIVE';
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl1 (col int) TABLEGROUP = tblgroup6;
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl2(col1 INT,col2 VARCHAR(50)) TABLEGROUP = tblgroup6
      PARTITION BY LIST(col1) SUBPARTITION BY LIST COLUMNS(col2)
        (PARTITION p0 VALUES in (01)
           (SUBPARTITION mp0 VALUES in ('01'),
            SUBPARTITION mp1 VALUES in ('02'),
            SUBPARTITION mp2 VALUES in ('03')
         ),
        PARTITION p1 VALUES in (02)
           (SUBPARTITION mp3 VALUES in ('01'),
            SUBPARTITION mp4 VALUES in ('02'),
            SUBPARTITION mp5 VALUES in ('03'))
         );
  ERROR 4179 (HY000): not all tables are non-partitioned or partitioned, add table to tablegroup not allowed
  

• tblgroup7 という名前のテーブルグループを作成し、その SHARDING プロパティを ADAPTIVE に設定します。パーティションテーブル tbl1 とパーティションテーブル tbl2 のパーティションタイプは同じですが、サブパーティションのタイプが異なる（サブパーティションの数が異なる）ため、同時にこのグループに追加することはできません。

  obclient> CREATE TABLEGROUP tblgroup7 SHARDING = 'ADAPTIVE';
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl1(col1 INT,col2 VARCHAR(50)) TABLEGROUP = tblgroup7
      PARTITION BY LIST(col1) SUBPARTITION BY LIST COLUMNS(col2)
        (PARTITION p0 VALUES in (01)
          (SUBPARTITION mp0 VALUES in ('01'),
            SUBPARTITION mp1 VALUES in ('02'),
            SUBPARTITION mp2 VALUES in ('03')
            ),
         PARTITION p1 VALUES in (02)
            (SUBPARTITION mp3 VALUES in ('01'),
             SUBPARTITION mp4 VALUES in ('02'),
             SUBPARTITION mp5 VALUES in ('03'))
        );
  Query OK, 0 rows affected
  
  obclient> CREATE TABLE tbl2(col1 INT,col2 VARCHAR(50)) TABLEGROUP = tblgroup7
      PARTITION BY LIST(col1) SUBPARTITION BY LIST COLUMNS(col2)
        (PARTITION p0 VALUES in (01)
           (SUBPARTITION mp0 VALUES in ('01'),
            SUBPARTITION mp1 VALUES in ('02')),
         PARTITION p1 VALUES in (02)
           (SUBPARTITION mp3 VALUES in ('01'),
            SUBPARTITION mp4 VALUES in ('02'))
         );
  ERROR 4179 (HY000): subpartition num not matched, add table to tablegroup not allowed
  

関連ドキュメント

• ALTER TABLEGROUP

• DROP TABLEGROUP

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

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