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

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

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

制限事項と注意点

• 現在のバージョンでは、動的パーティションテーブルを作成するには、少なくとも1つのパーティション定義を指定する必要があります。
• 動的パーティション管理を有効にできるのは、Rangeパーティションで、かつパーティションキーが date、timestamp、timestamp with local time zone、number（BIGINT_PRECISION 精度を指定）タイプの場合のみです。
• 動的パーティション管理は、パーティションテーブルおよびサブパーティションテーブルのパーティションに対してのみ有効です。
• テーブル作成後の事前作成パーティションと期限切れパーティションの削除は、即座には実行されません。次回の動的パーティション管理タスクの自動スケジュールを待つか、手動で動的パーティション管理タスクを1回スケジュールする必要があります。動的パーティション管理タスクのスケジュールに関する詳細は、動的パーティション管理タスクを参照してください。

権限要件

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

構文

動的パーティションテーブルを作成する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を参照してください。

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

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

例

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

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

CREATE TABLE test_tbl1 (col1 INT, col2 TIMESTAMP)
    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 (col2)(
        PARTITION P0 VALUES LESS THAN (TIMESTAMP '2024-11-11 13:30:00')
        );

関連ドキュメント

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