更新映射表屬性列

前提條件

• 已初始化Client。具體操作，請參見初始化Tablestore Client。

• 已建立映射關係。具體操作，請參見建立映射關係。

注意事項

• 只有通過CREATE TABLE語句建立的映射表才支援使用ALTER TABLE語句更新屬性列。通過DESCRIBE等操作自動綁定的映射表不支援使用ALTER TABLE語句更新屬性列。

• ALTER TABLE語句每次僅支援添加或者刪除一列。如果需要進行多列操作，請重複執行ALTER TABLE語句。

• ALTER TABLE語句只支援更新映射表的Schema，不會更新Table Store的資料存放區Schema。

• ALTER TABLE語句不支援添加或者刪除映射表主鍵列的操作。

• 執行ALTER TABLE語句後，SQL引擎會非同步進行重新整理，最多需30秒完成重新整理。在此期間執行返回所有列等操作時可能不會返回新添加的列。

參數

樣本

• 添加屬性列

  以下樣本為exampletable映射表添加BIGINT類型的colvalue屬性列。

  const params = {
    query: "alter table exampletable add column colvalue bigint",
  }
  
  client.sqlQuery(params, function (err, data) {
    if (err) {
      console.log('sqlQuery error:', err.toString());
    } else {
      console.log('sqlQuery success:', data);
    }
  });

• 刪除屬性列

  以下樣本刪除exampletable映射表中的colvalue（BIGINT類型）屬性列。

  const params = {
    query: "alter table exampletable drop column colvalue",
  }
  
  client.sqlQuery(params, function (err, data) {
    if (err) {
      console.log('sqlQuery error:', err.toString());
    } else {
      console.log('sqlQuery success:', data);
    }
  });

常見問題

• 更新映射表屬性列時報錯Unsupported operation: Unsupported alter non-mapping table

• SQL查詢常見錯誤排查

相關文檔

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

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

• 如需查看錶的描述資訊，可以通過DESCRIBE語句實現。更多資訊，請參見查詢表的描述資訊。

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

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

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