云原生数据库 PolarDB：普通表快速转换为RANGE分区表

普通表快速转RANGE分区表

• 语法

  在ALTER TABLE语句中添加WITHOUT VALIDATION关键字。

  ALTER TABLE table_name
  PARTITION BY RANGE {(expr) | COLUMNS(column_list)}
  (partition_definition [, partition_definition] ...)
  WITHOUT VALIDATION;

  其中，partition_definition如下：

  PARTITION partition_name
         VALUES LESS THAN {(value | value_list) | MAXVALUE}

• 参数说明

  参数	参数说明
  table_name	表名称。
  column_list	LIST COLUMNS类型使用，分区字段列表，不支持表达式。
  RANGE(expr)	RANGE分区字段表达式。
  partition_name	分区名称。
  value_list	字段的边界值。
  MAXVALUE	最大值。

• 示例

  将普通表t1转为RANGE分区表。

  CREATE TABLE t1 (
  `a` int ,
  `b` int ,
  Primary Key(a, b));
  
  insert into t1 values(1,1),(2,1),(3,1),(4,1),(111,111),(3333,333);
  
  alter table t1 partition by range(a) (
    partition p0 values less than (100),
    partition p1 values less than (200)
  ) WITHOUT VALIDATION;

  t1表的所有数据会不经校验的全部转到partition p0，如果您确认普通表的数据全部符合p0定义的边界，可以使用该语法快速的进行普通表快速转RANGE分区表。

  说明

  • 请务必保证普通表中的数据全部符合分区表第一个分区定义的边界，否则转成分区表之后，不符合分区规则的数据可能会查询不到。

  • 当使用WITHOUT VALIDATION选项时，系统会将普通表的所有数据不经校验地迁移至目标分区的第一个分区区域。请确保DDL中指定的分区边界是与普通表的全部数据匹配。

组合使用语法

普通表快速转RANGE分区表WITHOUT VALIDATION可以搭配INTERVAL分区表（自动创建相同间隔的RANGE分区）组合使用。示例如下：

CREATE TABLE t1(
 ID int,
 DATE DATE,
 PRIMARY KEY (ID,DATE)
);
ALTER TABLE t1 
partition by RANGE COLUMNS(date) INTERVAL(DAY, 1) (
  PARTITION p0 VALUES LESS THAN ('2023-01-31')
) without validation;