更新映射表属性列

前提条件

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

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

注意事项

• 执行ALTER TABLE语句仅支持更新映射表的Schema，不会更新表格存储的数据存储Schema。
• 不支持添加或者删除映射表主键列的操作。
• 执行ALTER TABLE语句后，SQL引擎会异步进行刷新，最多30秒完成刷新。在此期间执行返回所有列等操作时可能不会返回新添加的列。
• 只有通过CREATE TABLE语句创建的映射表才支持使用ALTER TABLE语句更新属性列。通过DESCRIBE操作自动绑定的映射表不支持使用ALTER TABLE语句更新属性列。
• ALTER TABLE语句每次仅支持添加或者删除一列。如果需要进行多列操作，请执行多次ALTER TABLE语句。

参数

示例

• 为映射表添加属性列

  以下示例用于为exampletable映射表添加colvalue（BIGINT类型）属性列。

  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（BIGINT类型）属性列。

  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语句实现。更多信息，请参见列出映射表名称列表。