オートパーティションスプリット

OceanBaseデータベースでは、事前に自動パーティションルールを設定し、データが一定の規模に達すると自動的にパーティション分割操作を行います。これにより、データ増加時のテーブル拡張を自動化し、単一パーティションにおけるデータ量過多によるロードバランシングやパフォーマンスへの影響を回避できます。

自動のパーティション分割操作のサポート状況

現在のバージョンでは、Range/Range Columnsパーティション方式のパーティションに主キーを持つテーブルに対してのみ、自動パーティション分割機能がサポートされています。

制限事項と注意点

• リスト型およびハッシュ型パーティションテーブルの自動スプリットはサポートされていません。
• セカンダリパーティションテーブルの自動スプリットはサポートされていません。
• スプリットされるテーブルのパーティションキーと主キーのプレフィックスが異なる場合、自動スプリットはサポートされていません。
• 主キーを持たないテーブルの自動スプリットはサポートされていません。
• 列指向ストアテーブルの自動スプリットはサポートされていません。
• 列指向ストアレプリカの自動スプリットはサポートされていません。
• テーブルが属する TABLEGROUP（テーブルグループ）に複数のテーブルが含まれている場合、自動スプリットはサポートされません。この TABLEGROUP にのみこのテーブルが含まれる場合、自動スプリットはサポートされます。
• マテリアライズドビューの自動スプリットはサポートされていません。
• 全テキストインデックスの自動スプリットはサポートされていません。
• GISインデックスの自動スプリットはサポートされていません。
• ベクトルインデックスの自動スプリットはサポートされていません。
• OceanBaseデータベースはV4.3.5 BP2バージョンから、global_index_auto_split_policy構成パラメータをサポートしており、新規作成されたグローバルインデックスに自動パーティション機能を有効にするかどうかを制御します。自動パーティションが有効な場合、新しいグローバルインデックスはデータ量に基づいてパーティションルールを再生成します。これは予備的なスプリットです。

テーブルレベルの自動パーティション構成に基づく

CREATE TABLE 時に、SIZE 句を設定して単一の自動パーティションテーブルを作成します。

テーブル作成時の自動パーティション構文

CREATE TABLE table_name (column_definition_list, PRIMARY KEY(column_name_list))
    PARTITION BY RANGE [COLUMNS]([column_name_list]) [SIZE('size_value')]
    [(range_partition_list)];

column_definition_list:
    column_definition[, column_definition ...]

column_name_list:
    column_name[, column_name ...]

range_partition_list:
    PARTITION partition_name VALUES LESS THAN (value_list)[, PARTITION partition_name VALUES LESS THAN (value_list) ...]

value_list:
    value[, value ...]

パラメータの説明

テーブルの自動パーティションプロパティを変更する構文

ALTER TABLE table_name
    PARTITION BY RANGE [COLUMNS]([column_name_list]) [SIZE('size_value')]
    [(range_partition_list)];

column_name_list:
    column_name[, column_name ...]

range_partition_list:
    PARTITION partition_name VALUES LESS THAN (value_list)[, PARTITION partition_name VALUES LESS THAN (value_list) ...]

value_list:
    value[, value ...]

パラメータの説明

テナントレベルの自動パーティション構成

テナントレベルの構成パラメータ enable_auto_split と auto_split_tablet_size を設定することで、グローバル設定に基づいてテナント内の条件を満たすテーブルに対して自動分割を制御します。CREATE TABLE 時に SIZE 構文を省略した場合、以下のテナントレベルの構成パラメータに基づいて自動パーティションテーブルが作成されるかどうかを決定します（デフォルトでは主キー列を自動パーティションテーブルのパーティションキーとして使用します）。

• enable_auto_split：テナントレベルの構成パラメータで、テナントが自動パーティション機能を有効にするかどうかを制御します。デフォルトは無効です。
• auto_split_tablet_size：テナントレベルの構成パラメータで、テナントが自動パーティション機能を有効にした後の分割をトリガーするしきい値を制御します。デフォルト値は128MBです。

SIZE 構文を省略し、かつ enable_auto_split を true に設定した場合、分割しきい値を満たすテーブルのみに自動パーティションが設定され、その他のテーブルには適用されません。例えば、セカンダリパーティションテーブル、非 RANGE パーティションテーブル、主キーを持たないテーブル、またはパーティションキーが主キーのプレフィックスと一致しないパーティションテーブルを作成する場合、自動パーティションテーブルではなく通常のパーティションテーブルが作成されます（ユーザーが手動で自動パーティションの特別な構文を記述した場合は依然としてエラーが発生します）。

自動パーティションの動作の説明

自動パーティションDDL操作

• パーティションルールの変更：1次パーティションを主キーに基づくRangeパーティションに変更する以外、他のパーティションルールの変更はサポートされていません。
• 主キーの変更：主キーを変更した後、自動パーティションキーが主キーのプレフィックスである必要があります。
• 列操作：予約パーティションキーの操作制限はパーティションキーと同じです。

DML動作

スプリット中は、スプリット前後の2つのスキーマが同時に存在するように扱われます。ソースパーティションとターゲットパーティションのDML動作は、同一データに対する操作として扱われます。例えば、ソースパーティションへの書き込みやクエリは、対応するターゲットパーティションへの書き込みやクエリに変換されます。また、ターゲットパーティションへの書き込みやクエリは、ソースパーティションから転送された書き込みを認識します。具体的には以下の通りです：

例

例1：テーブルレベルの自動パーティションテーブルを作成する

1. 自動パーティション機能をオフにします。

   AlTER SYSTEM SET enable_auto_split = FALSE;
   

   説明

   SHOW PARAMETERS LIKE 'enable_auto_split';を使用して、自動パーティション機能が有効になっているかどうかを確認できます。

2. 分割しきい値を10GBに設定し、事前パーティションキーを指定せずに自動パーティションテーブル test1_tbl1 を作成します。

   CREATE TABLE test1_tbl1 (col1 INT, col2 INT, col3 VARCHAR(30), PRIMARY KEY(col1, col2))
       PARTITION BY RANGE() SIZE('10GB');
   

3. 事前パーティションキーを col1、分割しきい値を10GBに設定して、自動パーティションテーブル test1_tbl2 を作成します。

   CREATE TABLE test1_tbl2 (col1 INT, col2 INT, col3 VARCHAR(30), PRIMARY KEY(col1, col2))
       PARTITION BY RANGE(col1) SIZE('10GB');
   

4. 事前パーティションキーと分割しきい値を指定せず、自動パーティションテーブル test1_tbl3 を作成します（分割しきい値はデフォルトで auto_split_tablet_size の値を使用します）。

   CREATE TABLE test1_tbl3 (col1 INT, col2 INT, col3 VARCHAR(30), PRIMARY KEY(col1, col2))
       PARTITION BY RANGE();
   

5. 事前パーティションキーを col1, col2、分割しきい値を10GBに設定し、事前にパーティションポイント P0、P1、P2、P3 を作成して、自動パーティションテーブル test1_tbl4 を作成します。

   CREATE TABLE test1_tbl4 (col1 INT, col2 INT, col3 VARCHAR(30), PRIMARY KEY(col1, col2))
       PARTITION BY RANGE COLUMNS(col1, col2) SIZE('10GB')
           (PARTITION P0 VALUES LESS THAN (100, MAXVALUE),
            PARTITION P1 VALUES LESS THAN (500, MAXVALUE),
            PARTITION P2 VALUES LESS THAN (800, MAXVALUE),
            PARTITION P3 VALUES LESS THAN (MAXVALUE, MAXVALUE));
   

6. テーブルの自動パーティションプロパティを確認します。

   SELECT TABLE_SCHEMA, TABLE_NAME, AUTO_SPLIT, AUTO_SPLIT_TABLET_SIZE
   FROM information_schema.TABLES
   WHERE TABLE_NAME LIKE "test1%"
   ORDER BY TABLE_NAME;
   

   実行結果は次のとおりです：

   +--------------+------------+------------+------------------------+
   | TABLE_SCHEMA | TABLE_NAME | AUTO_SPLIT | AUTO_SPLIT_TABLET_SIZE |
   +--------------+------------+------------+------------------------+
   | db_test      | test1_tbl1 | TRUE       |            10737418240 |
   | db_test      | test1_tbl2 | TRUE       |            10737418240 |
   | db_test      | test1_tbl3 | TRUE       |              134217728 |
   | db_test      | test1_tbl4 | TRUE       |            10737418240 |
   +--------------+------------+------------+------------------------+
   4 rows in set
   

例2：テーブルの自動パーティションプロパティを変更する

1. 自動パーティションテーブル test2_tbl1 を作成し、プリパーティションキーを col1、スプリットしきい値を10GBに指定します。

   CREATE TABLE test2_tbl1 (col1 INT, col2 INT, col3 VARCHAR(30), PRIMARY KEY(col1, col2))
       PARTITION BY RANGE(col1) SIZE('10GB');
   

2. テーブル test2_tbl1 の自動パーティションしきい値を1GBに変更します。

   ALTER TABLE test2_tbl1 PARTITION BY RANGE() SIZE('1GB');
   

   または

   ALTER TABLE test2_tbl1 PARTITION BY RANGE(col1) SIZE('1GB');
   

3. 自動パーティションテーブル test2_tbl2 を作成し、プリパーティションキーを col1、スプリットしきい値を10GBに指定します。また、パーティションポイント p0（値が100未満の行）、p1（値が100以上かつ200未満の行）、および p_max（値が200以上の行）を事前に作成します。

   CREATE TABLE test2_tbl2 (col1 INT, col2 INT, col3 VARCHAR(30), PRIMARY KEY(col1, col2))
       PARTITION BY RANGE(col1) SIZE('10GB')
           (PARTITION p0 VALUES LESS THAN(100),
            PARTITION p1 VALUES LESS THAN(200),
            PARTITION p_max VALUES LESS THAN (MAXVALUE));
   

4. テーブル test2_tbl2 の自動パーティションしきい値を5GBに変更し、事前に作成されたパーティションポイントを p0（値が300未満の行）と p_max（値が300以上の行）に変更します。

   ALTER TABLE test2_tbl2
       PARTITION BY RANGE(col1) SIZE('5GB')
           (PARTITION p0 VALUES LESS THAN(300),
            PARTITION p_max VALUES LESS THAN (MAXVALUE));
   

5. 自動パーティションテーブル test2_tbl3 を作成し、プリパーティションキーを col1、スプリットしきい値を10GBに指定します。

   CREATE TABLE test2_tbl3 (col1 INT, col2 INT, col3 VARCHAR(30), PRIMARY KEY(col1, col2))
       PARTITION BY RANGE(col1) SIZE('10GB');
   

6. テーブル test2_tbl3 の自動パーティションを無効にし、変更後は既存のパーティションには影響を与えず、以降新しい自動パーティションのスプリットはスケジュールされません。

   ALTER TABLE test2_tbl3 PARTITION BY RANGE() SIZE('unlimited');
   

7. 自動パーティションテーブル test2_tbl4 を作成し、プリパーティションキーを col1、スプリットしきい値を10GBに指定します。

   CREATE TABLE test2_tbl4 (col1 INT, col2 INT, col3 VARCHAR(30), PRIMARY KEY(col1, col2))
       PARTITION BY RANGE(col1) SIZE('10GB');
   

8. テーブル test2_tbl4 のプリパーティションキーを col1 から col1,col2 に変更します。

   ALTER TABLE test2_tbl4 PARTITION BY RANGE COLUMNS(col1,col2) SIZE('10GB');
   

9. 非自動パーティションテーブル test2_tbl5 を作成します。

   CREATE TABLE test2_tbl5 (col1 INT, col2 INT, col3 VARCHAR(30), PRIMARY KEY(col1, col2));
   

10. SIZE 句を指定せずに、テーブル test2_tbl5 を自動パーティションテーブルに変更すると、スプリットしきい値はデフォルトで auto_split_tablet_size の値が使用されます。

    ALTER TABLE test2_tbl5 PARTITION BY RANGE COLUMNS(col1);
    

11. テーブルの自動パーティションプロパティを確認します。

    SELECT TABLE_SCHEMA, TABLE_NAME, AUTO_SPLIT, AUTO_SPLIT_TABLET_SIZE
    FROM information_schema.TABLES
    WHERE TABLE_NAME LIKE "test2%"
    ORDER BY TABLE_NAME;
    

    実行結果は次のとおりです：

    +--------------+------------+------------+------------------------+
    | TABLE_SCHEMA | TABLE_NAME | AUTO_SPLIT | AUTO_SPLIT_TABLET_SIZE |
    +--------------+------------+------------+------------------------+
    | db_test      | test2_tbl1 | TRUE       |             1073741824 |
    | db_test      | test2_tbl2 | TRUE       |             5368709120 |
    | db_test      | test2_tbl3 | FALSE      |                      0 |
    | db_test      | test2_tbl4 | TRUE       |            10737418240 |
    | db_test      | test2_tbl5 | TRUE       |              134217728 |
    +--------------+------------+------------+------------------------+
    5 rows in set
    

例3：自動パーティション機能を有効にした後にテーブルを作成する

1. 自動パーティション機能を有効にします。

   AlTER SYSTEM SET enable_auto_split = TRUE;
   

2. パーティションテーブル test3_tbl1 を作成します。テナントレベルですべてのパーティションテーブルが自動的に SIZE パーティションを使用するように設定されているため、以下の通常のテーブル作成構文は自動パーティション化を行い、テナントレベルの構成パラメータ（デフォルトの128MBをスプリットしきい値として使用）を読み取ります。

   CREATE TABLE test3_tbl1 (col1 INT, col2 INT, PRIMARY KEY(col1));
   

3. パーティションテーブル test3_tbl2 を自動パーティション化して作成します（デフォルトの128MBをスプリットしきい値として使用）。パーティションキーを指定していないため、デフォルトではプライマリキーを使用します。

   CREATE TABLE test3_tbl2 (col1 INT, col2 INT, PRIMARY KEY(col1))
       PARTITION BY RANGE ();
   

4. パーティションテーブル test3_tbl3 を自動パーティション化して作成します（スプリットしきい値は1024MB、ユーザー設定を使用）。

   CREATE TABLE test3_tbl3 (col1 INT, col2 INT, PRIMARY KEY(col1))
       PARTITION BY RANGE () SIZE('1024MB');
   

5. 非自動パーティションテーブル test3_tbl4 を作成します。

   CREATE TABLE test3_tbl4 (col1 INT, col2 INT, PRIMARY KEY(col1))
       PARTITION BY RANGE () SIZE('unlimited');
   

6. プライマリキーがないテーブルは自動パーティション化の要件を満たさないため、enable_auto_split = true であっても自動パーティション化は有効になりません。

   CREATE TABLE test3_tbl5 (col1 INT, col2 INT);
   

7. プライマリキーがないテーブルは自動パーティション化の要件を満たさないため、手動で自動パーティション化を有効にするとエラーが発生します。

   CREATE TABLE test3_tbl6 (col1 INT, col2 INT)
       PARTITION BY RANGE ();
   

   実行結果は次のとおりです：

   ERROR 1235 (0A000): auto partitioned table without primary key is not supported
   

8. テーブルの自動パーティションプロパティを確認します。

   SELECT TABLE_SCHEMA, TABLE_NAME, AUTO_SPLIT, AUTO_SPLIT_TABLET_SIZE
   FROM information_schema.TABLES
   WHERE TABLE_NAME LIKE "test3%"
   ORDER BY TABLE_NAME;
   

   実行結果は次のとおりです：

   +--------------+------------+------------+------------------------+
   | TABLE_SCHEMA | TABLE_NAME | AUTO_SPLIT | AUTO_SPLIT_TABLET_SIZE |
   +--------------+------------+------------+------------------------+
   | db_test      | test3_tbl1 | TRUE       |              134217728 |
   | db_test      | test3_tbl2 | TRUE       |              134217728 |
   | db_test      | test3_tbl3 | TRUE       |             1073741824 |
   | db_test      | test3_tbl4 | FALSE      |                      0 |
   | db_test      | test3_tbl5 | FALSE      |                      0 |
   +--------------+------------+------------+------------------------+
   5 rows in set
   

例4：グローバルインデックスの自動パーティション機能を有効にする

1. 自動パーティションテーブル test4_tbl1 を作成します（スプリットしきい値を1024MB、ユーザー設定を使用します）。

   CREATE TABLE test4_tbl1 (col1 INT, col2 INT, col3 INT, PRIMARY KEY(col1))
       PARTITION BY RANGE () SIZE('1024MB');
   

2. テーブル test4_tbl1 にグローバルインデックス idx1_test4_tbl1 を作成します。

   CREATE INDEX idx1_test4_tbl1 ON test4_tbl1 (col2) GLOBAL;
   

3. グローバルインデックスで自動パーティション機能を有効にします。

   ALTER SYSTEM SET global_index_auto_split_policy = 'ALL';
   

4. 非自動パーティションのパーティションテーブル test4_tbl2 を作成します。

   CREATE TABLE test4_tbl2(col1 INT, col2 INT, col3 INT, PRIMARY KEY(col1))
       PARTITION BY RANGE(col1)
       (PARTITION p0 VALUES LESS THAN(100),
       PARTITION p1 VALUES LESS THAN(200),
       PARTITION p2 VALUES LESS THAN(300));
   

5. テーブル test4_tbl2 にグローバルインデックス idx1_test4_tbl2 を作成します。

   CREATE INDEX idx1_test4_tbl2 ON test4_tbl2 (col2) GLOBAL;
   

関連ドキュメント

• enable_auto_split
• auto_split_tablet_size
• global_index_auto_split_policy
• ALTER TABLE