全部產品
Search
文件中心

Tablestore:更新映射表屬性列

更新時間:Oct 23, 2026

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

說明

關於ALTER TABLE語句的更多資訊,請參見DDL 操作。

前提條件

注意事項

  • 請先通過 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);
    }
說明

更新映射表屬性列時,您可以先刪除舊的無用屬性列,然後再添加新的屬性列。

常見問題

相關文檔

  • 如果要加速SQL資料查詢和計算,您可以通過建立二級索引或者多元索引實現。更多資訊,請參見索引選擇策略和計算下推。

  • 更新映射表屬性列後,您可以通過SELECT語句查詢與分析表中資料。更多資訊,請參見查詢資料。

  • 如果需要查詢表的描述資訊,您可以通過DESCRIBE語句實現。更多資訊,請參見查詢表的描述資訊。

  • 如果不再需要使用表或者多元索引的映射關係,您可以通過DROP MAPPING TABLE語句刪除映射關係。更多資訊,請參見刪除映射表。

  • 如果需要查看錶的索引資訊,您可以通過SHOW INDEX語句實現。更多資訊,請參見查詢索引描述資訊。

  • 如果需要列出當前資料庫中的表名稱列表,您可以通過SHOW TABLES語句實現。更多資訊,請參見列出映射表名稱列表。