表格存储：通过控制台使用二级索引

步骤一（可选）：添加预定义列

1. 进入表管理页面。

   1. 登录表格存储控制台。

   2. 在概览页面，单击实例名称。

   3. 在实例详情页签的数据表列表区域，单击数据表名称。

2. 在基本详情页签的高级功能模块中的预定义列区域，单击添加预定义列。

3. 在添加预定义列对话框中，单击添加预定义列，然后输入预定义列的名称和选择数据类型。

   • 预定义列名称命名规则为由大小写字母、数字或下划线（_）组成，且只能以字母或下划线（_）开头，长度在1到255个字节之间。

   • 预定义列的数据类型可选为字符串、整型、二进制、浮点数或布尔值。如果预定义列需要作为索引表的索引列，则数据类型请选择字符串、整型或二进制。

   说明

   通过单击添加预定义列，您可以添加多个预定义列；单击预定义列后的图标，可以删除不需要添加的预定义列。

   

4. 单击确定。

   新添加的预定义列会显示在预定义列列表中。

   如果要删除不需要的预定义列，请单击目标预定义列对应的图标进行删除。

步骤二：创建二级索引

创建一个二级索引用于加速数据查询。二级索引包括全局二级索引和本地二级索引，请根据实际情况创建。

1. 进入表管理页面。

   1. 登录表格存储控制台。

   2. 在概览页面，单击实例名称。

   3. 在实例详情页签的数据表列表区域，单击数据表名称。

2. 在索引管理页签，单击创建二级索引。

3. 在创建索引对话框中，创建二级索引。

   

   1. 根据下表说明配置索引参数。

      参数	描述
      索引类型	索引的类型，固定取值为二级索引。
      实例名	所选实例名称，无法修改。
      表名	所选数据表名称，无需修改。
      索引名	二级索引名称。 重要 索引名不能与已有的数据表名和时序表名相同。
      索引类型	二级索引的类型。取值范围如下： 全局二级索引：以异步方式将数据表中被索引的列和主键列的数据自动同步到索引表中。 索引表的第一列主键可根据需要选择任意主键列或预定义列。 本地二级索引：以同步方式将数据表中被索引的列和主键列的数据自动同步到索引表中，当数据写入数据表后即可从索引表中查询到数据。 索引表的第一列主键必须和数据表的第一列主键相同。
      存量数据	是否包含数据表中的存量数据。取值范围如下： 包含存量 不含存量

   2. 根据所需主键顺序依次选择主键列，单击增加主键列。

      只有字符串、整型和二进制类型的预定义列支持作为主键列。

   3. 选择作为属性列的预定义列，单击增加预定义列。

4. 单击确定。

   新添加的二级索引会显示在索引列表中。

步骤三：查询数据

通过单行查询或范围查询的方式读取索引表中的数据。

常见问题

• 如何选择二级索引和多元索引

• 如何使用预定义列

• 创建二级索引时报错Don't support allow update operation on table with index and ttl

• 读取二级索引时报错OTSErrorMsg: Disallow read index table in building base state

相关文档

• 您还可以使用SDK或命令行工具来使用二级索引。更多信息，请参见通过SDK使用二级索引和通过命令行工具使用二级索引。

• 如果需要更灵活丰富的数据加速查询方式，例如多条件组合查询、全文检索、前缀查询、模糊查询等，您可以使用多元索引实现。更多信息，请参见多元索引简介。