ALTER TABLE PARTITION

功能描述

修改表分区，包括增删分区、切割分区、合成分区，以及修改分区属性等。

注意事项

• 添加分区的名字不能与该分区表已有分区的名字相同。
• 添加分区的分区键值要和分区表的分区键的类型一致，且要大于分区表中最后一个范围分区的上边界。
• 如果目标分区表中已有分区数达到了最大值（32767），则不能继续添加分区。

• 当分区表只有一个分区时，不能删除该分区。
• 选择分区使用PARTITION FOR()，括号里指定值个数应该与定义分区时使用的列个数相同，并且一一对应。
• Value分区表不支持相应的Alter Partition操作。
• OBS冷热表对于move，exchange，merge，split操作，不支持指定分区表表空间为OBS表空间；执行ALTER语法时，需保持分区数据冷热属性不变（即冷分区操作后为冷分区，热分区操作后为热分区），不支持将冷分区数据切至本地表空间；对于冷分区仅支持默认表空间；merge操作不支持将冷分区与热分区进行合并，exchange操作不支持冷分区交换。

语法格式

• 修改表分区主语法。

  1 2	ALTER TABLE [ IF EXISTS ] { table_name [*] | ONLY table_name | ONLY ( table_name )} action [, ... ];

  其中action统指如下分区维护子语法。当存在多个分区维护子句时，保证了分区的连续性，无论这些子句的排序如何，GaussDB(DWS)总会先执行DROP PARTITION再执行ADD PARTITION操作，最后顺序执行其它分区维护操作。

  1 2 3 4 5 6 7 8

  move_clause | exchange_clause | row_clause | merge_clause | modify_clause | split_clause | add_clause | drop_clause

  • move_clause子语法用于移动分区到新的表空间。

    1	MOVE PARTITION { partition_name | FOR ( partition_value [, ...] ) } TABLESPACE tablespacename

  • exchange_clause子语法用于把普通表的数据迁移到指定的分区。

    1 2 3

    EXCHANGE PARTITION { ( partition_name ) | FOR ( partition_value [, ...] ) } WITH TABLE {[ ONLY ] ordinary_table_name | ordinary_table_name * | ONLY ( ordinary_table_name )} [ { WITH | WITHOUT } VALIDATION ] [ VERBOSE ]

    进行交换的普通表和分区表必须满足如下条件：

    • 普通表和分区表的列数目相同，对应列的信息严格一致，包括：列名、列的数据类型、列约束、列的Collation信息、列的存储参数、列的压缩信息、已删除字段的数据类型等。
    • 普通表和分区表的表压缩信息严格一致。
    • 普通表和分区表的分布列信息严格一致。
    • 普通表和分区表的索引个数相同，且对应索引的信息严格一致。
    • 普通表和分区表的表约束个数相同，且对应表约束的信息严格一致。
    • 普通表不可以是临时表和unlogged表。
    • 普通表和分区表必须在同一个逻辑集群或节点组（NodeGroup）中。
    • 如果行存分区表中最后一个有效字段后的其他字段全部被删除，在不考虑这些删除字段的情况下，分区表与普通表字段信息一致时，分区表和普通表可以进行交换。

    完成交换后，普通表和分区表的数据被置换，同时普通表和分区表的表空间信息被置换。此时，普通表和分区表的统计信息变得不可靠，需要对普通表和分区表重新执行analyze。

  • row_clause子语法用于设置分区表的行迁移开关。

    1	{ ENABLE | DISABLE } ROW MOVEMENT

  • merge_clause子语法用于把多个分区合并成一个分区。

    1 2	MERGE PARTITIONS { partition_name } [, ...] INTO PARTITION partition_name

  • modify_clause子语法用于设置分区索引是否可用。

    1	MODIFY PARTITION partition_name { UNUSABLE LOCAL INDEXES | REBUILD UNUSABLE LOCAL INDEXES }

  • split_clause子语法用于把一个分区切割成多个分区。

    1	SPLIT PARTITION { partition_name | FOR ( partition_value [, ...] ) } { split_point_clause | no_split_point_clause }

    • 指定切割点split_point_clause的语法为。

      1	AT ( partition_value ) INTO ( PARTITION partition_name , PARTITION partition_name )

      

      切割点的大小要位于正在被切割的分区的分区键范围内，指定切割点的方式只能把一个分区切割成两个新分区。

    • 不指定切割点no_split_point_clause的语法为。

      1	INTO { ( partition_less_than_item [, ...] ) | ( partition_start_end_item [, ...] ) }

      

      • 不指定切割点的方式，partition_less_than_item指定的第一个新分区的分区键要大于正在被切割的分区的前一个分区（如果存在的话）的分区键，partition_less_than_item指定的最后一个分区的分区键要等于正在被切割的分区的分区键大小。
      • 不指定切割点的方式，partition_start_end_item指定的第一个新分区的起始点（如果存在的话）必须等于正在被切割的分区的前一个分区（如果存在的话）的分区键，partition_start_end_item指定的最后一个分区的终止点（如果存在的话）必须等于正在被切割的分区的分区键。
      • partition_less_than_item支持的分区键个数最多为4，而partition_start_end_item仅支持1个分区键，其支持的数据类型参见Partition Key。
    • 分区项partition_less_than_item的语法为。

      1 2	PARTITION partition_name VALUES LESS THAN ( { partition_value | MAXVALUE } [, ...] ) [ TABLESPACE tablespacename ]

    • 分区项partition_start_end_item的语法为，其约束参见START END语法描述。

      1 2 3 4 5 6

      PARTITION partition_name { {START(partition_value) END (partition_value) EVERY (interval_value)} | {START(partition_value) END ({partition_value | MAXVALUE})} | {START(partition_value)} | {END({partition_value | MAXVALUE})} } [TABLESPACE tablespace_name]

  • add_clause子语法用于为指定的分区表添加一个或多个分区。

    1	ADD {partition_less_than_item | partition_start_end_item}

  • drop_clause子语法用于删除分区表中的指定分区。

    1	DROP PARTITION { partition_name | FOR ( partition_value [, ...] ) }

• 修改表分区名字的语法。

  1 2	ALTER TABLE [ IF EXISTS ] { table_name [*] | ONLY table_name | ONLY ( table_name )} RENAME PARTITION { partition_name | FOR ( partition_value [, ...] ) } TO partition_new_name;

参数说明

• table_name

  分区表名。

  取值范围：已存在的分区表名。

• partition_name

  分区名。

  取值范围：已存在的分区名。

• partition_value

  分区键值。

  通过PARTITION FOR ( partition_value [, ...] )子句指定的这一组值，可以唯一确定一个分区。

  取值范围：需要进行重命名的分区的分区键的取值范围。

• UNUSABLE LOCAL INDEXES

  设置该分区上的所有索引不可用。

• REBUILD UNUSABLE LOCAL INDEXES

  重建该分区上的所有索引。

• ENABLE/DISABLE ROW MOVEMENT

  行迁移开关。

  如果进行UPDATE操作时，更新了元组在分区键上的值，造成了该元组所在分区发生变化，就会根据该开关给出报错信息，或者进行元组在分区间的转移。

  取值范围：

  • ENABLE：打开行迁移开关。
  • DISABLE：关闭行迁移开关。

  默认是关闭状态。

• ordinary_table_name

  进行迁移的普通表的名称。

  取值范围：已存在的普通表名。

• { WITH | WITHOUT } VALIDATION

  在进行数据迁移时，是否检查普通表中的数据满足指定分区的分区键范围。

  取值范围：

  • WITH：对于普通表中的数据要检查是否满足分区的分区键范围，如果有数据不满足，则报错。
  • WITHOUT：对于普通表中的数据不检查是否满足分区的分区键范围。

  默认是WITH状态。

  由于检查比较耗时，特别是当数据量很大的情况下更甚。所以在保证当前普通表中的数据满足分区的分区键范围时，可以加上WITHOUT来指明不进行检查。

• VERBOSE

  在VALIDATION是WITH状态时，如果检查出普通表有不满足要交换分区的分区键范围的数据，那么把这些数据插入到正确的分区，如果路由不到任何分区，再报错。

  

  只有在VALIDATION是WITH状态时，才可以指定VERBOSE。

• partition_new_name

  分区的新名字。

  取值范围：字符串，要符合标识符的命名规范。

示例

删除分区P8：

ALTER TABLE tpcds.web_returns_p1 DROP PARTITION P8;

增加分区WR_RETURNED_DATE_SK介于2453005和2453105之间：

ALTER TABLE tpcds.web_returns_p1 ADD PARTITION P8 VALUES LESS THAN (2453105);

增加分区WR_RETURNED_DATE_SK介于2453105和MAXVALUE之间：

ALTER TABLE tpcds.web_returns_p1 ADD PARTITION P9 VALUES LESS THAN (MAXVALUE);

分区P7重命名为P10：

ALTER TABLE tpcds.web_returns_p1 RENAME PARTITION P7 TO P10;

分区P6重命名为P11：

ALTER TABLE tpcds.web_returns_p1 RENAME PARTITION FOR (2452639) TO P11;

查询分区P10的行数：

SELECT count(*) FROM tpcds.web_returns_p1 PARTITION (P10);
 count  
--------
 9362
(1 row)

以2453010为分割点切分P8：

1
2
3
4
5

ALTER TABLE tpcds.web_returns_p2 SPLIT PARTITION P8 AT (2453010) INTO
(
        PARTITION P9,
        PARTITION P10
); 

将P6，P7合并为一个分区：

1

ALTER TABLE tpcds.web_returns_p2 MERGE PARTITIONS P6, P7 INTO PARTITION P8;

修改分区表迁移属性：

1

ALTER TABLE tpcds.web_returns_p2 DISABLE ROW MOVEMENT;

相关链接

CREATE TABLE PARTITION，DROP TABLE