執行ALTER TABLE語句為已存在的映射表添加或刪除屬性列。
說明
關於ALTER TABLE語句的更多資訊,請參見DDL 操作。
前提條件
-
已初始化Client。具體操作,請參見初始化Tablestore Client。
-
已建立映射關係。具體操作,請參見建立映射關係。
注意事項
-
請先通過
CREATE TABLE語句為資料表建立映射表,再使用ALTER TABLE語句更新屬性列。 -
每條
ALTER TABLE語句僅支援添加或刪除一個屬性列。如需操作多個屬性列,需重複執行ALTER TABLE語句。 -
ALTER TABLE語句只更新映射表的 Schema,不會更新Table Store的資料存放區 Schema。 -
ALTER TABLE語句不支援添加或刪除映射表的主鍵列。 -
執行
ALTER TABLE語句後,SQL 引擎會非同步重新整理映射表,最多需要 30 秒。重新整理期間,查詢全部屬性列時可能不會返回新添加的列。 -
如需修改已有屬性列的定義,先使用
DROP COLUMN刪除原屬性列,再使用ADD COLUMN按新定義添加屬性列。
參數
參數 | 說明 |
query | SQL語句,請根據所需功能進行設定。 |
樣本
-
為映射表添加屬性列
以下樣本用於為exampletable映射表添加colvalue(BIGINT類型)屬性列。
/// <summary> /// 為exampletable映射表添加colvalue(BIGINT類型)屬性列。 /// </summary> /// <param name="otsClient"></param> public static void AlterTableAddColumn(OTSClient otsClient) { SQLQueryRequest sqlQueryRequest = new SQLQueryRequest("alter table exampletable add column colvalue bigint"); otsClient.SQLQuery(sqlQueryRequest); } -
刪除映射表的屬性列
以下樣本用於刪除exampletable映射表中的colvalue(BIGINT類型)屬性列。
/// <summary> /// 為exampletable映射表刪除colvalue(BIGINT類型)屬性列。。 /// </summary> /// <param name="otsClient"></param> public static void AlterTableDropColumn(OTSClient otsClient) { SQLQueryRequest sqlQueryRequest = new SQLQueryRequest("alter table exampletable drop column colvalue"); otsClient.SQLQuery(sqlQueryRequest); }
說明
更新映射表屬性列時,您可以先刪除舊的無用屬性列,然後再添加新的屬性列。