ALTER TABLE PROPERTY

警告

分区属性与表属性的一些区别

分区属性一般主要关注分桶数 (buckets)、存储介质 (storage_medium)、副本数 (replication)、冷热分离存储策略 (storage_policy)；
- 对于已经创建的分区，可以使用 alter table {tableName} modify partition({partitionName}) set ({key}={value}) 来修改，但是分桶数 (buckets) 不能修改；
- 对于未创建的动态分区 (dynamic partition)，可以使用 alter table {tableName} set (dynamic_partition.{key} = {value}) 来修改其属性；
- 对于未创建的自动分区 (auto partition)，可以使用 alter table {tableName} set ({key} = {value}) 来修改其属性；
- 若用户想修改分区的属性，需要修改已经创建分区的属性，同时也要修改未创建分区的属性
除了上面几个属性，其他均为表级别属性
具体属性可以参考建表属性

描述

该语句用于对已有 table 的 property 进行修改操作。这个操作是同步的，命令返回表示执行完毕。

语法：

ALTER TABLE [database.]table alter_clause;

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

修改表的 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");

修改表的 Colocate 属性

ALTER TABLE example_db.my_table set ("colocate_with" = "t1");

将表的分桶方式由 Hash Distribution 改为 Random Distribution

ALTER TABLE example_db.my_table set ("distribution_type" = "random");

修改表的动态分区属性 (支持未添加动态分区属性的表添加动态分区属性)

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"
);

修改表的 in_memory 属性，只支持修改为'false'

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

启用批量删除功能

ALTER TABLE example_db.my_table ENABLE FEATURE "BATCH_DELETE";

注意：

只能用在 unique 表
用于旧表支持批量删除功能，新表创建时已经支持

启用按照 sequence column 的值来保证导入顺序的功能

ALTER TABLE example_db.my_table ENABLE FEATURE "SEQUENCE_LOAD" WITH PROPERTIES (
  "function_column.sequence_type" = "Date"
);

注意：

只能用在 unique 表
sequence_type 用来指定 sequence 列的类型，可以为整型和时间类型
只支持新导入数据的有序性，历史数据无法更改

将表的默认分桶数改为 50

只能用在 unique 表
sequence_type 用来指定 sequence 列的类型，可以为整型和时间类型
只支持新导入数据的有序性，历史数据无法更改

ALTER TABLE example_db.my_table MODIFY DISTRIBUTION DISTRIBUTED BY HASH(k1) BUCKETS 50;

注意：

只能用在分区类型为 RANGE，采用哈希分桶的非 colocate 表
只能用在分区类型为 RANGE，采用哈希分桶的非 colocate 表

修改表注释

ALTER TABLE example_db.my_table MODIFY COMMENT "new comment";

修改列注释

ALTER TABLE example_db.my_table MODIFY COLUMN k1 COMMENT "k1", MODIFY COLUMN k2 COMMENT "k2";

修改引擎类型

仅支持将 MySQL 类型修改为 ODBC 类型。driver 的值为 odbc.init 配置中的 driver 名称。

ALTER TABLE example_db.mysql_table MODIFY ENGINE TO odbc PROPERTIES("driver" = "MySQL");

修改副本数

ALTER TABLE example_db.mysql_table SET ("replication_num" = "2");
ALTER TABLE example_db.mysql_table SET ("default.replication_num" = "2");
ALTER TABLE example_db.mysql_table SET ("replication_allocation" = "tag.location.default: 1");
ALTER TABLE example_db.mysql_table SET ("default.replication_allocation" = "tag.location.default: 1");

注：

default 前缀的属性表示修改表的默认副本分布。这种修改不会修改表的当前实际副本分布，而只影响分区表上新建分区的副本分布。
对于非分区表，修改不带 default 前缀的副本分布属性，会同时修改表的默认副本分布和实际副本分布。即修改后，通过 show create table 和 show partitions from tbl 语句可以看到副本分布数据都被修改了。
对于分区表，表的实际副本分布是分区级别的，即每个分区有自己的副本分布，可以通过 show partitions from tbl 语句查看。如果想修改实际副本分布，请参阅 ALTER TABLE PARTITION。
[Experimental] 打开light_schema_change

对于建表时未开启 light_schema_change 的表，可以通过如下方式打开。

ALTER TABLE example_db.mysql_table SET ("light_schema_change" = "true");

示例

修改表的 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"
);

修改表的 Colocate 属性

ALTER TABLE example_db.my_table set ("colocate_with" = "t1");

将表的分桶方式由 Hash Distribution 改为 Random Distribution

ALTER TABLE example_db.my_table set (
  "distribution_type" = "random"
);

修改表的动态分区属性 (支持未添加动态分区属性的表添加动态分区属性)

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"
);

修改表的 in_memory 属性，只支持修改为'false'

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

启用批量删除功能

ALTER TABLE example_db.my_table ENABLE FEATURE "BATCH_DELETE";

启用按照 sequence column 的值来保证导入顺序的功能

ALTER TABLE example_db.my_table ENABLE FEATURE "SEQUENCE_LOAD" WITH PROPERTIES (
  "function_column.sequence_type" = "Date"
);

将表的默认分桶数改为 50

ALTER TABLE example_db.my_table MODIFY DISTRIBUTION DISTRIBUTED BY HASH(k1) BUCKETS 50;

修改表注释

ALTER TABLE example_db.my_table MODIFY COMMENT "new comment";

修改列注释

ALTER TABLE example_db.my_table MODIFY COLUMN k1 COMMENT "k1", MODIFY COLUMN k2 COMMENT "k2";

修改引擎类型

ALTER TABLE example_db.mysql_table MODIFY ENGINE TO odbc PROPERTIES("driver" = "MySQL");

给表添加冷热分层数据迁移策略

 ALTER TABLE create_table_not_have_policy set ("storage_policy" = "created_create_table_alter_policy");

注：表没有关联过 storage policy，才能被添加成功，一个表只能添加一个 storage policy

给表的 partition 添加冷热分层数据迁移策略

ALTER TABLE create_table_partition MODIFY PARTITION (*) SET("storage_policy"="created_create_table_partition_alter_policy");

注：表的 partition 没有关联过 storage policy，才能被添加成功，一个表只能添加一个 storage policy

给表的 partition 添加冷热分层数据迁移策略

ALTER TABLE create_table_partition MODIFY PARTITION (*) SET("storage_policy"="created_create_table_partition_alter_policy");

注：表的 partition 没有关联过 storage policy，才能被添加成功，一个表只能添加一个 storage policy

关键词

ALTER, TABLE, PROPERTY, ALTER TABLE

描述​

示例​

关键词​

最佳实践​

描述

示例

关键词

最佳实践