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

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

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

使用上の制限と注意事項

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

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

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

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

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

権限要件

動的パーティションテーブルを作成するには、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 を作成し、動的パーティションの属性を以下のように設定します：

• パーティションの境界は毎時に設定します。
• 現在時刻から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')
    );

関連ドキュメント

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