创建动态分区表

OceanBase Database AI 通过 DYNAMIC_PARTITION_POLICY 块，在建表时指定表的动态分区管理属性。

本文将向您介绍如何使用 SQL 语句创建动态分区表。

使用限制及注意事项

• 当前版本创建动态分区表需要至少指定一个分区定义。

• 仅支持 Range Columns 分区和 Range 分区：

  • Range Columns 分区：分区键为 date、datetime、timestamp、year、bigint（指定 BIGINT_PRECISION 精度）类型的分区表可开启动态分区管理。
  • Range 分区：分区键为 year、bigint（指定 BIGINT_PRECISION 精度）类型的分区表可开启动态分区管理。

• 仅能对一级分区表和二级分区表的一级分区开启动态分区管理。

• 建表后预创建分区和删除过期分区的动作不会立刻执行，需要等待下一次动态分区管理任务自动调度，或者手动调度一次动态分区管理任务。调度动态分区管理任务的详细介绍，参见 动态分区管理任务。

权限要求

创建动态分区表需要有 CREATE 权限。更多有关 OceanBase Database AI 权限的详细介绍，参见 权限分类。

语法

创建动态分区表的 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：只有分区键类型为 bigint 时，才可以指定该参数值为 us、ms、s，其他分区键类型时该参数值只能为 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')
    );

相关文档

• 动态分区概述
• 查看动态分区表
• 修改动态分区表
• 动态分区管理任务