更新映射表属性列

前提条件

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

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

注意事项

• 请先通过 CREATE TABLE 语句为数据表创建映射表，再使用 ALTER TABLE 语句更新属性列。

• 每条 ALTER TABLE 语句仅支持添加或删除一个属性列。如需操作多个属性列，需重复执行 ALTER TABLE 语句。

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

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

• 执行 ALTER TABLE 语句后，SQL 引擎会异步刷新映射表，最多需要 30 秒。刷新期间，查询全部属性列时可能不会返回新添加的列。

• 如需修改已有属性列的定义，先使用 DROP COLUMN 删除原属性列，再使用 ADD COLUMN 按新定义添加属性列。

参数

示例

• 为映射表添加属性列

  以下示例用于为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);
  }

常见问题

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

• SQL查询常见错误排查

相关文档

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

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

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

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

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

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