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'}
動的パーティション管理プロパティパラメータの説明
プロパティ名 |
説明 |
必須 |
変更は可能か |
|---|---|---|---|
| ENABLE | 動的パーティション管理を有効にするかどうかを示します。値は以下のとおりです：
|
いいえ | はい |
| TIME_UNIT | パーティションの時間単位、つまり自動的にパーティション境界を作成する間隔を示します。値は以下のとおりです：
|
はい | いいえ |
| PRECREATE_TIME | 事前作成時間を示します。動的パーティション管理をスケジュールするたびに、パーティションを事前作成し、最大パーティション上界 > now() + precreate_time となるようにします。値は以下のとおりです：
説明
|
いいえ | はい |
| EXPIRE_TIME | パーティションの有効期限を示します。動的パーティション管理をスケジュールするたびに、パーティション上界 < now() - expire_time のすべての期限切れパーティションを削除します。値は以下のとおりです：
|
いいえ | はい |
| TIME_ZONE | 現在時刻と日付型（date、timestamp型）のパーティションキーのサイズを比較する際に依存するタイムゾーン情報を示します。値は以下のとおりです：
|
いいえ | いいえ |
| BIGINT_PRECISION | number型のパーティションキーのタイムスタンプ精度を示します。値は以下のとおりです：
|
いいえ | いいえ |
テーブル作成構文の詳細なパラメータ説明については、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')
);
説明
テーブル作成後の事前パーティション作成および期限切れパーティションの削除は即座に実行されません。次回の動的パーティション管理タスクの自動スケジュールを待つか、手動で動的パーティション管理タスクを1回スケジュールする必要があります。詳細については、動的パーティション管理タスクを参照してください。