ALTER TABLE

description

该语句用于对已有的 table 进行修改。如果没有指定 rollup index,默认操作 base index。 该语句分为三种操作类型: schema change 、rollup 、partition 这三种操作类型不能同时出现在一条 ALTER TABLE 语句中。 其中 schema change 和 rollup 是异步操作,任务提交成功则返回。之后可使用 SHOW ALTER 命令查看进度。 partition 是同步操作,命令返回表示执行完毕。

语法:

ALTER TABLE [database.]table
alter_clause1[, alter_clause2, ...];

alter_clause 分为 partition、rollup、schema change、rename、index和swap六种。

partition 支持如下几种修改方式

  1. 增加分区

    语法:

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

    注意:

    1. partition_desc 支持一下两种写法:
      • VALUES LESS THAN [MAXVALUE|("value1", ...)]
      • VALUES [("value1", ...), ("value1", ...))
    2. 分区为左闭右开区间,如果用户仅指定右边界,系统会自动确定左边界
    3. 如果没有指定分桶方式,则自动使用建表使用的分桶方式
    4. 如指定分桶方式,只能修改分桶数,不可修改分桶方式或分桶列
    5. ["key"="value"] 部分可以设置分区的一些属性,具体说明见 CREATE TABLE
  2. 删除分区

    语法:

    DROP PARTITION [IF EXISTS] partition_name [FORCE]

    注意:

    1. 使用分区方式的表至少要保留一个分区。
    2. 执行 DROP PARTITION 一段时间内,可以通过 RECOVER 语句恢复被删除的分区。详见 RECOVER 语句
    3. 如果执行 DROP PARTITION FORCE,则系统不会检查该分区是否存在未完成的事务,分区将直接被删除并且不能被恢复,一般不建议执行此操作
  3. 修改分区属性

    语法:

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

    说明:

    1. 当前支持修改分区的下列属性:

      • storage_medium
      • storage_cooldown_time
      • replication_num
      • in_memory
    2. 对于单分区表,partition_name 同表名。

rollup 支持如下几种创建方式:

  1. 创建 rollup index

    语法:

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

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

    例子:

    ADD ROLLUP r1(col1,col2) from r0
  2. 批量创建 rollup index

    语法:

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

    例子:

    ADD ROLLUP r1(col1,col2) from r0, r2(col3,col4) from r0
  3. 注意:

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

    语法:

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

    例子:

    DROP ROLLUP r1

  5. 批量删除 rollup index

    语法:

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

    例子:DROP ROLLUP r1,r2 2.2 注意:

    1. 不能删除 base index

    schema change 支持如下几种修改方式:

  6. 向指定 index 的指定位置添加一列

    语法:

    ADD COLUMN column_name column_type [KEY | agg_type] [DEFAULT "default_value"]
    [AFTER column_name|FIRST]
    [TO rollup_index_name]
    [PROPERTIES ("key"="value", ...)]

    注意:

    1. 聚合模型如果增加 value 列,需要指定 agg_type
    2. 非聚合模型(如 DUPLICATE KEY)如果增加key列,需要指定KEY关键字
    3. 不能在 rollup index 中增加 base index 中已经存在的列
    如有需要,可以重新创建一个 rollup index)
  7. 向指定 index 添加多列

    语法:

    ADD COLUMN (column_name1 column_type [KEY | agg_type] DEFAULT "default_value", ...)
    [TO rollup_index_name]
    [PROPERTIES ("key"="value", ...)]

    注意:

    1. 聚合模型如果增加 value 列,需要指定agg_type
    2. 非聚合模型如果增加key列,需要指定KEY关键字
    3. 不能在 rollup index 中增加 base index 中已经存在的列 (如有需要,可以重新创建一个 rollup index)
  8. 从指定 index 中删除一列

    语法:

    DROP COLUMN column_name
    [FROM rollup_index_name]

    注意:

    1. 不能删除分区列
    2. 如果是从 base index 中删除列,则如果 rollup index 中包含该列,也会被删除
  9. 修改指定 index 的列类型以及列位置

    语法:

    MODIFY COLUMN column_name column_type [KEY | agg_type] [NULL | NOT NULL] [DEFAULT "default_value"]
    [AFTER column_name|FIRST]
    [FROM rollup_index_name]
    [PROPERTIES ("key"="value", ...)]

    注意:

    1. 聚合模型如果修改 value 列,需要指定 agg_type
    2. 非聚合类型如果修改key列,需要指定KEY关键字
    3. 只能修改列的类型,列的其他属性维持原样(即其他属性需在语句中按照原属性显式的写出,参见 example 8)
    4. 分区列不能做任何修改
    5. 目前支持以下类型的转换(精度损失由用户保证) TINYINT/SMALLINT/INT/BIGINT 转换成 TINYINT/SMALLINT/INT/BIGINT/DOUBLE。 TINTINT/SMALLINT/INT/BIGINT/LARGEINT/FLOAT/DOUBLE/DECIMAL 转换成 VARCHAR VARCHAR 支持修改最大长度 VARCHAR 转换成 TINTINT/SMALLINT/INT/BIGINT/LARGEINT/FLOAT/DOUBLE VARCHAR 转换成 DATE (目前支持"%Y-%m-%d", "%y-%m-%d", "%Y%m%d", "%y%m%d", "%Y/%m/%d, "%y/%m/%d"六种格式化格式) DATETIME 转换成 DATE(仅保留年-月-日信息, 例如: 2019-12-09 21:47:05 <--> 2019-12-09) DATE 转换成 DATETIME(时分秒自动补零, 例如: 2019-12-09 <--> 2019-12-09 00:00:00) FLOAT 转换成 DOUBLE INT 转换成 DATE (如果INT类型数据不合法则转换失败,原始数据不变)
    6. 不支持从NULL转为NOT NULL
  10. 对指定 index 的列进行重新排序

    语法:

    ORDER BY (column_name1, column_name2, ...)
    [FROM rollup_index_name]
    [PROPERTIES ("key"="value", ...)]

    注意:

    1. index 中的所有列都要写出来
    2. value 列在 key 列之后
  11. 修改table的属性,目前支持修改bloom filter列, colocate_with 属性和dynamic_partition属性,replication_num和default.replication_num属性

    语法:

    PROPERTIES ("key"="value")

    注意: 也可以合并到上面的schema change操作中来修改,见下面例子

    rename 支持对以下名称进行修改:

example

  1. 修改表名

    语法:

    RENAME new_table_name;
  2. 修改 rollup index 名称

    语法:

    RENAME ROLLUP old_rollup_name new_rollup_name;
  3. 修改 partition 名称

    语法:

    RENAME PARTITION old_partition_name new_partition_name;

bitmap index 支持如下几种修改方式

  1. 创建bitmap 索引

    语法:

    ADD INDEX index_name (column [, ...],) [USING BITMAP] [COMMENT 'balabala'];

    注意:

    1. 目前仅支持bitmap 索引
    2. BITMAP 索引仅在单列上创建
  2. 删除索引

    语法:

    DROP INDEX index_name;

    swap 支持将两个表原子替换

  3. 将两个表原子替换

    语法:

    SWAP WITH table_name

[table]

  1. 修改表的默认副本数量, 新建分区副本数量默认使用此值

    ATLER TABLE example_db.my_table
    SET ("default.replication_num" = "2");
  2. 修改单分区表的实际副本数量(只限单分区表)

    ALTER TABLE example_db.my_table
    SET ("replication_num" = "3");

[partition]

  1. 增加分区, 现有分区 [MIN, 2013-01-01),增加分区 [2013-01-01, 2014-01-01),使用默认分桶方式

    ALTER TABLE example_db.my_table
    ADD PARTITION p1 VALUES LESS THAN ("2014-01-01");
  2. 增加分区,使用新的分桶数

    ALTER TABLE example_db.my_table
    ADD PARTITION p1 VALUES LESS THAN ("2015-01-01")
    DISTRIBUTED BY HASH(k1) BUCKETS 20;
  3. 增加分区,使用新的副本数

    ALTER TABLE example_db.my_table
    ADD PARTITION p1 VALUES LESS THAN ("2015-01-01")
    ("replication_num"="1");
  4. 修改分区副本数

    ALTER TABLE example_db.my_table
    MODIFY PARTITION p1 SET("replication_num"="1");
  5. 批量修改指定分区

    ALTER TABLE example_db.my_table
    MODIFY PARTITION (p1, p2, p4) SET("in_memory"="true");
  6. 批量修改所有分区

    ALTER TABLE example_db.my_table
    MODIFY PARTITION (*) SET("storage_medium"="HDD");
  7. 删除分区

    ALTER TABLE example_db.my_table
    DROP PARTITION p1;
  8. 增加一个指定上下界的分区

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

[rollup]

  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)
    PROPERTIES("storage_type"="column");
  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("storage_type"="column", "timeout" = "3600");
  4. 删除 index: example_rollup_index2

    ALTER TABLE example_db.my_table
    DROP ROLLUP example_rollup_index2;

[SchemaChange]

  1. 向 example_rollup_index 的 col1 后添加一个key列 new_col(非聚合模型)

    ALTER TABLE example_db.my_table
    ADD COLUMN new_col INT KEY DEFAULT "0" AFTER col1
    TO example_rollup_index;
  2. 向example_rollup_index的col1后添加一个value列new_col(非聚合模型)

    ALTER TABLE example_db.my_table
    ADD COLUMN new_col INT DEFAULT "0" AFTER col1
    TO example_rollup_index;
  3. 向example_rollup_index的col1后添加一个key列new_col(聚合模型)

    ALTER TABLE example_db.my_table
    ADD COLUMN new_col INT DEFAULT "0" AFTER col1
    TO example_rollup_index;
  4. 向example_rollup_index的col1后添加一个value列new_col SUM聚合类型(聚合模型)

    ALTER TABLE example_db.my_table
    ADD COLUMN new_col INT SUM DEFAULT "0" AFTER col1
    TO example_rollup_index;
  5. 向 example_rollup_index 添加多列(聚合模型)

    ALTER TABLE example_db.my_table
    ADD COLUMN (col1 INT DEFAULT "1", col2 FLOAT SUM DEFAULT "2.3")
    TO example_rollup_index;
  6. 从 example_rollup_index 删除一列

    ALTER TABLE example_db.my_table
    DROP COLUMN col2
    FROM example_rollup_index;
  7. 修改 base index 的 col1 列的类型为 BIGINT,并移动到 col2 列后面

    ALTER TABLE example_db.my_table
    MODIFY COLUMN col1 BIGINT DEFAULT "1" AFTER col2;
  8. 修改 base index 的 val1 列最大长度。原 val1 为 (val1 VARCHAR(32) REPLACE DEFAULT "abc")

    ALTER TABLE example_db.my_table
    MODIFY COLUMN val1 VARCHAR(64) REPLACE DEFAULT "abc";
  9. 重新排序 example_rollup_index 中的列(设原列顺序为:k1,k2,k3,v1,v2)

    ALTER TABLE example_db.my_table
    ORDER BY (k3,k1,k2,v2,v1)
    FROM example_rollup_index;
  10. 同时执行两种操作

    ALTER TABLE example_db.my_table
    ADD COLUMN v2 INT MAX DEFAULT "0" AFTER k2 TO example_rollup_index,
    ORDER BY (k3,k1,k2,v2,v1) FROM example_rollup_index;
  11. 修改表的 bloom filter 列

    ALTER TABLE example_db.my_table SET ("bloom_filter_columns"="k1,k2,k3");

    也可以合并到上面的 schema change 操作中(注意多子句的语法有少许区别)

    ALTER TABLE example_db.my_table
    DROP COLUMN col2
    PROPERTIES ("bloom_filter_columns"="k1,k2,k3");
  12. 修改表的Colocate 属性

    ALTER TABLE example_db.my_table set ("colocate_with" = "t1");
  13. 将表的分桶方式由 Random Distribution 改为 Hash Distribution

    ALTER TABLE example_db.my_table set ("distribution_type" = "hash");
  14. 修改表的动态分区属性(支持未添加动态分区属性的表添加动态分区属性)

    ALTER TABLE example_db.my_table set ("dynamic_partition.enable" = "false");

    如果需要在未添加动态分区属性的表中添加动态分区属性,则需要指定所有的动态分区属性

    ALTER TABLE example_db.my_table set ("dynamic_partition.enable" = "true", "dynamic_partition.time_unit" = "DAY", "dynamic_partition.end" = "3", "dynamic_partition.prefix" = "p", "dynamic_partition.buckets" = "32");
  15. 修改表的 in_memory 属性

    ALTER TABLE example_db.my_table set ("in_memory" = "true");

[rename]

  1. 将名为 table1 的表修改为 table2

    ALTER TABLE table1 RENAME table2;
  2. 将表 example_table 中名为 rollup1 的 rollup index 修改为 rollup2

    ALTER TABLE example_table RENAME ROLLUP rollup1 rollup2;
  3. 将表 example_table 中名为 p1 的 partition 修改为 p2

    ALTER TABLE example_table RENAME PARTITION p1 p2;

[index]

  1. 在table1 上为siteid 创建bitmap 索引

    ALTER TABLE table1 ADD INDEX index_name (siteid) [USING BITMAP] COMMENT 'balabala';
  2. 删除table1 上的siteid列的bitmap 索引

    ALTER TABLE table1 DROP INDEX index_name;

[swap]

  1. 将table1与table2原子替换

    ALTER TABLE table1 SWAP WITH table2

keyword

ALTER,TABLE,ROLLUP,COLUMN,PARTITION,RENAME,SWAP