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

说明 关于创建映射表的具体操作，请参见创建表的映射关系。

注意事项

  • 执行ALTER TABLE语句仅支持更新映射表的Schema，不会更新表格存储的数据存储Schema。
  • 不支持添加或者删除映射表主键列的操作。
  • 执行ALTER TABLE语句后，SQL引擎会异步进行刷新，最多30秒完成刷新。在此期间执行返回所有列等操作时可能不会返回新添加的列。
  • 只有通过CREATE TABLE语句创建的映射表才支持使用ALTER TABLE语句更新属性列。通过DESCRIBE操作自动绑定的映射表不支持使用ALTER TABLE语句更新属性列。
  • ALTER TABLE语句每次仅支持添加或者删除一列。如果需要进行多列操作，请执行多次ALTER TABLE语句。

语法

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等多种数据类型。只有当option为ADD COLUMN时才需要配置此参数。

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;