執行ALTER TABLE
語句為已存在的映射表添加或刪除屬性列。
關於建立映射表的具體操作,請參見建立表的映射關係。
注意事項
只有通過
CREATE TABLE
語句建立的映射表才支援使用ALTER TABLE
語句更新屬性列。通過DESCRIBE
等操作自動綁定的映射表不支援使用ALTER TABLE
語句更新屬性列。ALTER TABLE
語句每次僅支援添加或者刪除一列。如果需要進行多列操作,請重複執行ALTER TABLE
語句。ALTER TABLE
語句僅支援更新映射表的Schema,不會更新Table Store的資料存放區Schema。ALTER TABLE
語句不支援添加或者刪除映射表主鍵列的操作。執行
ALTER TABLE
語句後,SQL引擎會非同步進行重新整理,最多需30秒完成重新整理。在此期間執行返回所有列等操作時可能不會返回新添加的列。
文法
ALTER TABLE table_name option column_name [data_type];
參數
參數 | 是否必選 | 說明 |
table_name | 是 | 映射表名,用於唯一標識一張映射表。 |
option | 是 | 可執行檔更新操作,取值範圍如下:
|
column_name | 是 | 列名。新添加的列名不能與映射表中已有列名相同。 SQL中的列名必須和原始表中的列名等效,例如原始表中列名為Aa,在SQL中列名必須使用Aa、AA、aA或者aa中的一個。 |
data_type | 否 | 列的資料類型,包含BIGINT、DOUBLE、BOOL等多種資料類型。只有當option為ADD 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;