ALTER-TABLE-ROLLUP

ALTER-TABLE-ROLLUP

Name

ALTER TABLE ROLLUP

Description

该语句用于对已有 table 进行 rollup 进行修改操作。rollup 是异步操作，任务提交成功则返回，之后可使用SHOW ALTER 命令查看进度。

语法：

ALTER TABLE [database.]table alter_clause;

rollup 的 alter_clause 支持如下几种创建方式

1. 创建 rollup index

语法：

ADD ROLLUP rollup_name (column_name1, column_name2, ...)
[FROM from_index_name]
[PROPERTIES ("key"="value", ...)]

properties: 支持设置超时时间，默认超时时间为1天。

2. 批量创建 rollup index

语法：

ADD ROLLUP [rollup_name (column_name1, column_name2, ...)
                    [FROM from_index_name]
                    [PROPERTIES ("key"="value", ...)],...]

注意：

• 如果没有指定 from_index_name，则默认从 base index 创建
• rollup 表中的列必须是 from_index 中已有的列
• 在 properties 中，可以指定存储格式。具体请参阅 CREATE TABLE

3. 删除 rollup index

语法：

DROP ROLLUP rollup_name [PROPERTIES ("key"="value", ...)]

4. 批量删除 rollup index

语法：

DROP ROLLUP [rollup_name [PROPERTIES ("key"="value", ...)],...]

注意：

• 不能删除 base index

Example

1. 创建 index: example_rollup_index，基于 base index（k1,k2,k3,v1,v2）。列式存储。

ALTER TABLE example_db.my_table
ADD ROLLUP example_rollup_index(k1, k3, v1, v2);

2. 创建 index: example_rollup_index2，基于 example_rollup_index（k1,k3,v1,v2）

ALTER TABLE example_db.my_table
ADD ROLLUP example_rollup_index2 (k1, v1)
FROM example_rollup_index;

3. 创建 index: example_rollup_index3, 基于 base index (k1,k2,k3,v1), 自定义 rollup 超时时间一小时。

ALTER TABLE example_db.my_table
ADD ROLLUP example_rollup_index(k1, k3, v1)
PROPERTIES("timeout" = "3600");

4. 删除 index: example_rollup_index2

ALTER TABLE example_db.my_table
DROP ROLLUP example_rollup_index2;

5. 批量删除Rollup

ALTER TABLE example_db.my_table
DROP ROLLUP example_rollup_index2,example_rollup_index3;

Keywords

ALTER, TABLE, ROLLUP, ALTER TABLE

Best Practice