自動パーティションの分割

OceanBaseデータベースでは、事前に自動パーティション分割ルールを設定し、データ量が一定の基準に達すると自動的にパーティションの分割処理を実行します。これにより、データの増加に応じてデータベーステーブルを自動的に拡張でき、単一パーティションのデータ量が過大になることによるロードバランシングやパフォーマンスの問題を回避できます。

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

現在のバージョンでは、Rangeパーティションのパーティションにおいてのみ、主キーテーブルで自動パーティション機能がサポートされています。

使用上の制限と注意事項

• ListパーティションやHashパーティションテーブルの自動分割はサポートされていません。
• セカンダリパーティションテーブルの自動分割はサポートされていません。
• 自動分割されるテーブルのパーティションキーと主キーのプレフィックスが異なる場合はサポートされていません。
• 主キーを持たないテーブルの自動パーティション分割はサポートされていません。
• カラムストアテーブルの自動パーティション分割はサポートされていません。
• カラムストアレプリカの自動パーティション分割はサポートされていません。
• テーブルが属するTABLEGROUP（テーブルグループ）に複数のテーブルが含まれる場合、自動パーティション分割はサポートされていません。このTABLEGROUPにこのテーブルのみが含まれる場合は、自動パーティション分割がサポートされます。
• マテリアライズドビューの自動パーティション分割はサポートされていません。
• 全文インデックスの自動分割はサポートされていません。
• 空間インデックスの自動分割はサポートされていません。
• ベクトルインデックスの自動分割はサポートされていません。
• OceanBaseデータベースは global_index_auto_split_policy構成パラメータをサポートしており、新規作成されるグローバルインデックスで自動パーティション機能を有効にするかどうかを制御します。新規作成されたグローバルインデックスで自動パーティションが有効になっている場合、データ量に応じてパーティションルールが再生成され、事前に分割されます。

テーブル単位の自動パーティション設定

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

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

CREATE TABLE table_name (column_definition_list, PRIMARY KEY(column_name_list))
    PARTITION BY RANGE([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
    [MODIFY] PARTITION BY RANGE([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：テナントレベルのパラメータで、テナントの自動パーティション機能が有効な場合に分割をトリガーするしきい値を制御します。

SIZE 句が省略され、かつ enable_auto_split が true に設定されている場合、分割制限に合致するテーブルにのみ自動パーティションが設定され、制限に合致しないテーブルには適用されません。例えば、サブパーティションテーブル、非Rangeパーティションテーブル、主キーのないテーブル、またはパーティションキーと主キーのプレフィックスが一致しないテーブルを作成すると、通常は非自動パーティションテーブルとして作成されます（ユーザーが手動で自動分割の特別な句を記述した場合でもエラーが発生します）。

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

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

• パーティションルールの変更：パーティションを主キーによるRangeパーティションに変更する場合のみサポートされます。その他のパーティションルールの変更はサポートされません。
• 主キーの変更：主キーを変更した後、自動パーティションキーが主キーのプレフィックスである必要があります。
• 列操作：プリパーティションキーの操作制限は、パーティションキーと同じです。

DML動作

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

例

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

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

   AlTER SYSTEM SET enable_auto_split = FALSE;
   

   説明

   SHOW PARAMETERS LIKE 'enable_auto_split'; を実行すると、自動パーティション機能が有効かどうか確認できます。

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

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

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

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

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

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

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

   CREATE TABLE test1_tbl4 (col1 NUMBER, col2 NUMBER, col3 VARCHAR2(30), PRIMARY KEY(col1, col2))
       PARTITION BY RANGE(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 OWNER, TABLE_NAME, AUTO_SPLIT, AUTO_SPLIT_TABLET_SIZE
   FROM sys.ALL_TABLES
   WHERE TABLE_NAME LIKE 'TEST1%'
   ORDER BY TABLE_NAME;
   

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

   +-------+------------+------------+------------------------+
   | OWNER | TABLE_NAME | AUTO_SPLIT | AUTO_SPLIT_TABLET_SIZE |
   +-------+------------+------------+------------------------+
   | SYS   | TEST1_TBL1 | TRUE       | 10737418240            |
   | SYS   | TEST1_TBL2 | TRUE       | 10737418240            |
   | SYS   | TEST1_TBL3 | TRUE       | 134217728              |
   | SYS   | TEST1_TBL4 | TRUE       | 10737418240            |
   +-------+------------+------------+------------------------+
   4 rows in set
   

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

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

   CREATE TABLE test2_tbl1 (col1 NUMBER, col2 NUMBER, col3 VARCHAR2(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に指定します。

   CREATE TABLE test2_tbl2 (col1 NUMBER, col2 NUMBER, col3 VARCHAR2(30), PRIMARY KEY(col1, col2))
       PARTITION BY RANGE(col1) SIZE('10GB');
   

4. テーブル test2_tbl2 にパーティションポイント p0（値が100未満の行）、p1（値が100以上200未満の行）、p_max（値が200以上の行）を追加します。

   ALTER TABLE test2_tbl2
       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));
   

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

   CREATE TABLE test2_tbl3 (col1 NUMBER, col2 NUMBER, col3 VARCHAR2(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 NUMBER, col2 NUMBER, col3 VARCHAR2(30), PRIMARY KEY(col1, col2))
       PARTITION BY RANGE(col1) SIZE('10GB');
   

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

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

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

   CREATE TABLE test2_tbl5 (col1 NUMBER, col2 NUMBER, col3 VARCHAR2(30), PRIMARY KEY(col1, col2));
   

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

    ALTER TABLE test2_tbl5 PARTITION BY RANGE (col1);
    

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

    SELECT OWNER, TABLE_NAME, AUTO_SPLIT, AUTO_SPLIT_TABLET_SIZE
    FROM sys.ALL_TABLES
    WHERE TABLE_NAME LIKE 'TEST2%'
    ORDER BY TABLE_NAME;
    

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

    +-------+------------+------------+------------------------+
    | OWNER | TABLE_NAME | AUTO_SPLIT | AUTO_SPLIT_TABLET_SIZE |
    +-------+------------+------------+------------------------+
    | SYS   | TEST2_TBL1 | TRUE       | 1073741824             |
    | SYS   | TEST2_TBL2 | TRUE       | 10737418240            |
    | SYS   | TEST2_TBL3 | FALSE      | 0                      |
    | SYS   | TEST2_TBL4 | TRUE       | 10737418240            |
    | SYS   | TEST2_TBL5 | TRUE       | 134217728              |
    +-------+------------+------------+------------------------+
    5 rows in set
    

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

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

   AlTER SYSTEM SET enable_auto_split = TRUE;
   

2. 非パーティションテーブル test3_tbl1 を作成します。テナントレベルで、すべての非パーティションテーブルが自動的に SIZE パーティションを使用するよう設定されているため、通常のテーブル作成構文は自動的にパーティションを作成し、テナントレベルのパラメータを読み取ります。

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

3. 自動パーティションの非パーティションテーブル test3_tbl2 を作成します。パーティションキーを指定していないため、デフォルトで主キーがパーティションキーとして使用されます。

   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 ();
   

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

   OBE-00600: internal error code, arguments: -4007, auto partitioned table without primary key is not supported
   

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

   SELECT OWNER, TABLE_NAME, AUTO_SPLIT, AUTO_SPLIT_TABLET_SIZE
   FROM sys.ALL_TABLES
   WHERE TABLE_NAME LIKE 'TEST3%'
   ORDER BY TABLE_NAME;
   

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

   +-------+------------+------------+------------------------+
   | OWNER | TABLE_NAME | AUTO_SPLIT | AUTO_SPLIT_TABLET_SIZE |
   +-------+------------+------------+------------------------+
   | SYS   | TEST3_TBL1 | TRUE       | 134217728              |
   | SYS   | TEST3_TBL2 | TRUE       | 134217728              |
   | SYS   | TEST3_TBL3 | TRUE       | 1073741824             |
   | SYS   | TEST3_TBL4 | FALSE      | 0                      |
   | SYS   | 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