描述

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

语法：

1ALTER TABLE [database.]table alter_clause;

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

1. 创建 rollup index

   语法：

   SQL 复制

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

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

2. 批量创建 rollup index

   语法：

   SQL 复制

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

   注意：

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

3. 删除 rollup index

   语法：

   SQL 复制

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

4. 批量删除 rollup index

   语法：

   SQL 复制

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

   注意：不能删除 base index

示例

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

   SQL 复制

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

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

   SQL 复制

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

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

   SQL 复制

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

4. 删除 index: example_rollup_index2

   SQL 复制

   1ALTER TABLE example_db.my_table
   2DROP ROLLUP example_rollup_index2;

5. 批量删除 Rollup

   SQL 复制

   1ALTER TABLE example_db.my_table
   2DROP ROLLUP example_rollup_index2,example_rollup_index3;

关键词

ALTER, TABLE, ROLLUP, ALTER TABLE

最佳实践