更新映射表属性列

前提条件

• 已初始化Client。具体操作，请参见初始化Tablestore Client。

• 已创建映射关系。具体操作，请参见创建映射关系。

注意事项

• 只有通过CREATE TABLE语句创建的映射表才支持使用ALTER TABLE语句更新属性列。通过DESCRIBE等操作自动绑定的映射表不支持使用ALTER TABLE语句更新属性列。

• ALTER TABLE语句每次仅支持添加或者删除一列。如果需要进行多列操作，请重复执行ALTER TABLE语句。

• ALTER TABLE语句只支持更新映射表的Schema，不会更新表格存储的数据存储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语句实现。更多信息，请参见列出表名称列表。