单表多搜索索引（公测中）

前提条件

• 云原生多模数据库 Lindorm宽表引擎为2.8.2.3及以上版本。如何查看或升级当前版本，请参见升级小版本。

• 云原生多模数据库 LindormLTS引擎为3.8.12.5及以上版本。如何查看或升级当前版本，请参见升级小版本。

使用限制

• 单个主表上最多支持创建5个搜索索引。

• 同一个主表上的搜索索引不允许相互同名、不允许与其它类型的索引同名。

使用方法

1. 创建宽表。

   CREATE TABLE testTable (pk INT, c1 INT, c2 VARCHAR, c3 LONG, PRIMARY KEY(pk));

   说明

   Lindorm搜索索引的多索引特性目前处于公测阶段，如需体验该功能，请联系Lindorm技术支持（钉钉号：s0s3eg3）开启。

2. 在同一个宽表上可建立多个搜索索引。每个搜索索引的索引列及属性可以相同。

   CREATE INDEX idx1 USING SEARCH ON testTable (c1,c2);
   CREATE INDEX idx2 USING SEARCH ON testTable (c3);
   CREATE INDEX idx3 USING SEARCH ON testTable (c1,c2,c3);

3. 向宽表中写入数据，数据会同步到每个搜索索引中。

   UPSERT INTO testTable(pk,c1,c2,c3) VALUES (1,1,'1',1);
   UPSERT INTO testTable(pk,c1,c2,c3) VALUES (2,2,'2',2);
   UPSERT INTO testTable(pk,c1,c2,c3) VALUES (3,3,'3',3);
   UPSERT INTO testTable(pk,c1,c2,c3) VALUES (4,4,'4',4);

4. 数据查询。根据查询条件的不同，将自动选择合适的搜索索引。如果有多个搜索索引均覆盖了查询条件，将会选择其中一个。

   1. 查询c1、c2和c3列，自动选择索引idx3。

      SELECT * FROM testTable WHERE c1>0 AND c2>'0' AND c3>0;

   2. 查询c1和c2列，索引idx1和idx3均可覆盖，将会选择索引idx1或idx3。

      SELECT * FROM testTable WHERE c1>0 AND c2>'0';

   3. 查询c3列，索引idx2和idx3均可覆盖，将会选择索引idx2或idx3。

      SELECT * FROM testTable WHERE c3>0;

5. 查询时显式指定索引。

   可通过HINT语法显式指定某个搜索索引用于查询。

   SELECT /*+ _l_force_index_('idx1') */ * FROM testTable WHERE c1>0 AND c2>'0';

6. 控制索引的状态。

   可通过ALTER INDEX语句独立控制各个索引的状态。

   ALTER INDEX idx1 ON testTable INACTIVE;
   ALTER INDEX idx1 ON testTable DISABLED;

   状态值	说明
   ACTIVE	该搜索索引可用于查询，宽表数据会自动构建索引。
   INACTIVE	该搜索索引不可用于查询，宽表数据仍然会自动构建索引。
   DISABLED	该搜索索引不可用于查询，宽表数据不会构建索引。

   说明

   处于DISABLED状态的搜索索引，不能够再切换到其他状态，需要执行REBUILD才可重新启用。