執行ALTER TABLE語句為已存在的映射表添加或刪除屬性列。

说明 關於建立映射表的具體操作，請參見建立表的映射關係。

注意事項

  • 執行ALTER TABLE語句僅支援更新映射表的Schema，不會更新Tablestore的資料存放區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;