ALTER-TABLE-PARTITION

ALTER TABLE PARTITION

该语句用于对已有 table 的 partition 进行修改操作。

这个操作是同步的，命令返回表示执行完毕。

语法：

ALTER TABLE [database.]table alter_clause;

partition 的 alter_clause 支持如下几种修改方式

语法：

ADD PARTITION [IF NOT EXISTS] partition_name
partition_desc ["key"="value"]
[DISTRIBUTED BY HASH (k1[,k2 ...]) [BUCKETS num]]

注意：

partition_desc 支持以下两种写法
- VALUES LESS THAN [MAXVALUE|("value1", ...)]
- VALUES [("value1", ...), ("value1", ...))
分区为左闭右开区间，如果用户仅指定右边界，系统会自动确定左边界
如果没有指定分桶方式，则自动使用建表使用的分桶方式和分桶数。
如指定分桶方式，只能修改分桶数，不可修改分桶方式或分桶列。如果指定了分桶方式，但是没有指定分桶数，则分桶数会使用默认值 10，不会使用建表时指定的分桶数。如果要指定分桶数，则必须指定分桶方式。
["key"="value"] 部分可以设置分区的一些属性，具体说明见 CREATE TABLE
如果建表时用户未显式创建 Partition,则不支持通过 ALTER 的方式增加分区

语法：

DROP PARTITION [IF EXISTS] partition_name [FORCE]

注意：

语法：

MODIFY PARTITION p1|(p1[, p2, ...]) SET ("key" = "value", ...)

说明：

当前支持修改分区的下列属性：
- storage_medium
- storage_cooldown_time
- replication_num
- in_memory
对于单分区表，partition_name 同表名。

ALTER TABLE example_db.my_table
ADD PARTITION p1 VALUES LESS THAN ("2014-01-01");

ALTER TABLE example_db.my_table
ADD PARTITION p1 VALUES LESS THAN ("2015-01-01")
DISTRIBUTED BY HASH(k1) BUCKETS 20;

ALTER TABLE example_db.my_table
ADD PARTITION p1 VALUES LESS THAN ("2015-01-01")
("replication_num"="1");

ALTER TABLE example_db.my_table
MODIFY PARTITION p1 SET("replication_num"="1");

ALTER TABLE example_db.my_table
MODIFY PARTITION (p1, p2, p4) SET("in_memory"="true");

ALTER TABLE example_db.my_table
MODIFY PARTITION (*) SET("storage_medium"="HDD");

ALTER TABLE example_db.my_table
DROP PARTITION p1;

ALTER TABLE example_db.my_table
ADD PARTITION p1 VALUES [("2014-01-01"), ("2014-02-01"));

ALTER, TABLE, PARTITION, ALTER TABLE