全部產品
Search
文件中心

Tablestore:更新映射表屬性列

更新時間:Feb 07, 2025

執行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

可執行檔更新操作,取值範圍如下:

  • 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;

常見問題