更新映射表属性列

前提条件

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

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

注意事项

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

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

• ALTER TABLE语句只支持更新映射表的Schema，不会更新表格存储的数据存储Schema。

• ALTER TABLE语句不支持添加或者删除映射表主键列的操作。

• 执行ALTER TABLE语句后，SQL引擎会异步进行刷新，最多需30秒完成刷新。在此期间执行返回所有列等操作时可能不会返回新添加的列。

参数

示例

以下示例均通过 SQLQueryRequest 构造 SQL 请求，调用 client.SQLQuery 执行。响应结果中的 RequestId 可用于确认操作是否成功。

• 添加属性列

  以下示例为 exampletable 映射表添加 BIGINT 类型的 colvalue 属性列：

  func alterTableAddColumn(client *tablestore.TableStoreClient) {
      // 创建 SQL 请求。
      request := &tablestore.SQLQueryRequest{Query: "alter table exampletable add column colvalue bigint"}
  
      // 获取 SQL 的响应结果。
      res, err := client.SQLQuery(request)
      if err != nil {
          fmt.Println(err.Error())
      } else {
          fmt.Println(res.ResponseInfo.RequestId)
      }
  }

• 删除属性列

  以下示例删除 exampletable 映射表中的 colvalue 属性列：

  func alterTableDropColumn(client *tablestore.TableStoreClient) {
      // 创建 SQL 请求。
      request := &tablestore.SQLQueryRequest{Query: "alter table exampletable drop column colvalue"}
  
      // 获取 SQL 的响应结果。
      res, err := client.SQLQuery(request)
      if err != nil {
          fmt.Println(err.Error())
      } else {
          fmt.Println(res.ResponseInfo.RequestId)
      }
  }

常见问题

• 更新映射表属性列时报错Unsupported operation: Unsupported alter non-mapping table

• SQL查询常见错误排查

相关文档

• 如果要加速SQL数据查询和计算，您可以通过创建二级索引或者多元索引实现。更多信息，请参见索引选择策略和计算下推。

• 更新映射表属性列后，可通过 SELECT 语句查询表中数据。更多信息，请参见查询数据。

• 如需查看表的描述信息，可通过 DESCRIBE 语句实现。更多信息，请参见查询表的描述信息。

• 如不再需要使用表或多元索引的映射关系，可通过 DROP MAPPING TABLE 语句删除映射关系。更多信息，请参见删除映射表。

• 如需查看表的索引信息，可通过 SHOW INDEX 语句实现。更多信息，请参见查询索引描述信息。

• 如需列出当前数据库中的映射表名称，可通过 SHOW TABLES 语句实现。更多信息，请参见列出映射表名称列表。