動的パーティションテーブルの作成

OceanBaseデータベースでは、DYNAMIC_PARTITION_POLICYブロックを使用して、テーブル作成時にその動的パーティション管理の属性を指定します。

本記事では、SQLステートメントを使用して動的パーティションテーブルを作成する方法について説明します。

使用上の制限と注意事項

• 現在のバージョンでは、動的パーティションテーブルを作成するには、少なくとも1つのパーティション定義を指定する必要があります。

• Range ColumnsパーティションとRangeパーティションのみサポートされています：

  • Range Columnsパーティション：パーティションキーがdate、datetime、timestamp、year、bigint（BIGINT_PRECISION精度を指定）タイプのパーティションテーブルで動的パーティション管理を有効にできます。
  • Rangeパーティション：パーティションキーがyear、bigint（BIGINT_PRECISION精度を指定）タイプのパーティションテーブルで動的パーティション管理を有効にできます。

• 動的パーティション管理は、パーティションテーブルおよびサブパーティションテーブルのパーティションに対してのみ有効です。

• テーブル作成後の事前作成パーティションと期限切れパーティションの削除は即時には実行されません。次回の動的パーティション管理タスクの自動スケジュールを待つか、手動で動的パーティション管理タスクを1回スケジュールする必要があります。動的パーティション管理タスクのスケジュールに関する詳細は、動的パーティション管理タスクを参照してください。

権限要件

動的パーティションテーブルを作成するにはCREATE権限が必要です。OceanBaseデータベースの権限に関する詳細は、MySQLモードの権限分類を参照してください。

構文

動的パーティションテーブルを作成するSQLステートメントの形式は以下のとおりです：

CREATE TABLE [IF NOT EXISTS] table_name (table_definition_list)
    DYNAMIC_PARTITION_POLICY [=] (dynamic_partition_policy_list)
    partition_option;

dynamic_partition_policy_list:
    dynamic_partition_policy_option [, dynamic_partition_policy_option ...]

dynamic_partition_policy_option:
    ENABLE = {true | false}
    | TIME_UNIT = {'hour' | 'day' | 'week' | 'month' | 'year'}
    | PRECREATE_TIME = {'-1' | '0' | 'n {hour | day | week | month | year}'}
    | EXPIRE_TIME = {'-1' | '0' | 'n {hour | day | week | month | year}'}
    | TIME_ZONE = {'default' | 'time_zone'}
    | BIGINT_PRECISION = {'none' | 'us' | 'ms' | 's'}

動的パーティション管理属性パラメータの説明

テーブル作成構文の詳細なパラメータ説明については、CREATE TABLEを参照してください。

動的パーティションパラメータの制限

• TIME_UNIT：パーティションキーが date 型の場合、パラメータ TIME_UNIT では hour を使用できません。パーティションキーが year 型の場合、パラメータ TIME_UNIT では year のみを使用できます。
• PRECREATE_TIME：最大で2048個のパーティションを事前作成できます。
• TIME_ZONE：パーティションキーが date、datetime、または year 型の場合にのみ、パラメータ TIME_ZONE でカスタムタイムゾーンのオフセット値を指定できます。その他の型では default のみ指定可能です。
• BIGINT_PRECISION：このパラメータの値を us、ms、s に設定できるのは、パーティションキーの型が bigint の場合のみです。その他のパーティションキー型では、このパラメータの値は none のみとなります。
• TIME_UNIT、TIME_ZONE、BIGINT_PRECISION は指定後、変更できません。

例

動的パーティションテーブル test_tbl1 を作成し、動的パーティションの属性を以下のように設定します：

• パーティションの境界を1時間ごとに分割します。
• 現在時刻から3時間以内のパーティションを事前作成します。
• パーティションの上限が現在時刻の1日前より早いパーティションを削除します。
• 北京時間（UTC+8）を用いて時間を判断し、パーティションの境界と有効期限のロジックがこのタイムゾーンに基づくことを保証します。
• パーティションキー col2 は DATETIME 型であるため、bigint のタイムスタンプ精度を設定する必要はありません。

CREATE TABLE test_tbl1 (col1 INT, col2 DATETIME)
    DYNAMIC_PARTITION_POLICY(
        ENABLE = true,
        TIME_UNIT = 'hour',
        PRECREATE_TIME = '3 hour',
        EXPIRE_TIME = '1 day',
        TIME_ZONE = '+8:00',
        BIGINT_PRECISION = 'none'
    )
    PARTITION BY RANGE COLUMNS (col2)(
        PARTITION P0 VALUES LESS THAN ('2025-04-15 13:30:00')
    );

関連ドキュメント

• 動的パーティションの概要
• 動的パーティションテーブルの確認
• 動的パーティションテーブルの変更
• 動的パーティション管理タスク