更新映射表属性列

执行ALTER TABLE语句为已存在的映射表添加或删除属性列。

说明

关于创建映射表的具体操作,请参见创建表的映射关系

注意事项

  • 只有通过CREATE TABLE语句创建的映射表才支持使用ALTER TABLE语句更新属性列。通过DESCRIBE等操作自动绑定的映射表不支持使用ALTER TABLE语句更新属性列。

  • ALTER TABLE语句每次仅支持添加或者删除一列。如果需要进行多列操作,请重复执行ALTER TABLE语句。

  • ALTER TABLE语句只支持更新映射表的Schema,不会更新表格存储的数据存储Schema。

  • ALTER TABLE语句不支持添加或者删除映射表主键列的操作。

  • 执行ALTER TABLE语句后,SQL引擎会异步进行刷新,最多需30秒完成刷新。在此期间执行返回所有列等操作时可能不会返回新添加的列。

语法

ALTER TABLE table_name option column_name [data_type];

参数

参数

是否必选

说明

table_name

映射表名,用于唯一标识一张映射表。

option

可执行的更新操作,取值范围如下:

  • ADD COLUMN:在映射表中添加一个属性列。

  • DROP COLUMN:在映射表中删除一个属性列。

column_name

列名。新添加的列名不能与映射表中已有列名相同。

SQL中的列名必须和原始表中的列名等效,例如原始表中列名为Aa,在SQL中列名必须使用Aa、AA、aA或者aa中的一个。

data_type

列的数据类型,包含BIGINT、DOUBLE、BOOL等多种数据类型。只有当optionADD COLUMN时才需要配置此参数。

SQL中列的数据类型必须和原始表中列的数据类型相匹配。关于数据类型映射的更多信息,请参见SQL数据类型映射

示例

  • 为映射表添加属性列

    以下示例用于为exampletable映射表添加colvalue(BIGINT类型)和content(MEDIUMTEXT)属性列,请依次执行以下两条SQL语句。

    ALTER TABLE exampletable ADD COLUMN colvalue BIGINT;
    ALTER TABLE exampletable ADD COLUMN content MEDIUMTEXT;
  • 删除映射表的属性列

    以下示例用于删除exampletable映射表中的colvalue(BIGINT类型)属性列。

    ALTER TABLE exampletable DROP COLUMN colvalue;

常见问题