ダイナミックパーティションテーブルの作成

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

関連ドキュメント

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