虚拟列

通过控制台在创建多元索引时指定字段为虚拟列后，您可以使用虚拟列查询数据。

1. 进入索引管理页签。

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

   2. 在页面上方，选择地域和资源组。

   3. 在概览页面，单击实例名称或在操作列单击实例管理。

   4. 在实例详情页签的数据表列表区域，单击数据表名称或在操作列单击索引管理。

2. 在索引管理页签，单击创建多元索引。

3. 在创建索引对话框，创建多元索引时指定虚拟列。

   

   1. 系统默认会自动生成索引名，可根据需要输入索引名。

   2. 选择Schema生成方式。

      • 当Schema生成方式设置为手动录入时，手动输入字段名，选择字段类型以及设置是否开启数组。

      • 当Schema生成方式设置为自动生成时，系统会自动将数据表的主键列和属性列作为索引字段，可根据需要选择字段类型以及设置是否开启数组。

      说明

      字段名和字段类型需与数据表匹配。数据表字段类型与多元索引字段类型的对应关系请参见基础数据类型及映射。

   3. 创建虚拟列。

      重要

      创建虚拟列时，原始字段名必须在数据表中存在，且原始字段的数据类型必须和虚拟列的字段类型相匹配。

      1. 单击图标。

      2. 输入字段名和字段类型。

      3. 打开字段对应虚拟列的开关，并输入原始字段名。

   4. 如果要配置多元索引的路由键、数据生命周期或者预排序方式，请打开高级选项开关，并根据实际修改相应参数。更多信息，请参见创建多元索引。

   5. 单击确定。

      多元索引创建完成后，在多元索引的操作列，单击索引详情，您可以查看多元索引的索引基本信息、索引计量、路由键、索引字段和预排序等信息。

4. 使用虚拟列查询数据。

   1. 在多元索引的操作列单击搜索。

   2. 在查询数据对话框，查询数据。

      

      1. 系统默认返回所有列，如果需要显示指定属性列，关闭获取所有列并输入需要返回的属性列，多个属性列之间用半角逗号（,）隔开。

      2. 选择索引字段，单击添加，并设置索引字段的查询类型和值。

      3. 系统默认关闭排序功能，如需根据索引字段对返回结果进行排序，打开是否排序开关后，根据需要添加索引字段并配置排序方式。

      4. 系统默认关闭统计功能，如需对指定字段进行数据统计，打开是否统计开关后，根据需要添加要进行统计的字段和配置统计信息。

      5. 单击确定。

         符合查询条件的数据会显示在索引管理页签中。

通过 SDK 在创建多元索引时指定字段为虚拟列后，您可以使用虚拟列查询数据。

1. 创建多元索引时指定虚拟列。

   说明

   关于参数的详细说明，请参见创建多元索引。

   以下示例用于创建一个多元索引，多元索引包含 Col_Keyword 和 Col_Long 两列，同时创建虚拟列 Col_Keyword_Virtual_Long 和 Col_Long_Virtual_Keyword。Col_Keyword_Virtual_Long 映射为数据表中 Col_Keyword 列，虚拟列 Col_Long_Virtual_Keyword 映射为数据表中 Col_Long 列。

   private static void createSearchIndex(SyncClient client) {
       CreateSearchIndexRequest request = new CreateSearchIndexRequest();
       //设置数据表名称。
       request.setTableName("<TABLE_NAME>"); 
       //设置多元索引名称。
       request.setIndexName("<SEARCH_INDEX_NAME>"); 
       IndexSchema indexSchema = new IndexSchema();
       indexSchema.setFieldSchemas(Arrays.asList(
           //设置字段名和类型。
           new FieldSchema("Col_Keyword", FieldType.KEYWORD), 
           //设置字段名和类型。
           new FieldSchema("Col_Keyword_Virtual_Long", FieldType.LONG) 
                //设置字段是否为虚拟列。
               .setVirtualField(true) 
                //虚拟列对应的数据表中字段。
               .setSourceFieldName("Col_Keyword"), 
           new FieldSchema("Col_Long", FieldType.LONG),
           new FieldSchema("Col_Long_Virtual_Keyword", FieldType.KEYWORD)
               .setVirtualField(true)
               .setSourceFieldName("Col_Long")));
       request.setIndexSchema(indexSchema);
       //调用client创建多元索引。
       client.createSearchIndex(request); 
   }

2. 使用虚拟列查询数据。

   以下示例用于查询表中 Col_Long_Virtual_Keyword 列的值能够匹配 "1000" 的数据，返回匹配到的总行数和一些匹配成功的行。

   private static void query(SyncClient client) {
       SearchQuery searchQuery = new SearchQuery();
       TermsQuery termsQuery = new TermsQuery(); //设置查询类型为TermsQuery。
       termsQuery.setFieldName("Col_Long_Virtual_Keyword"); //设置要匹配的字段。
       termsQuery.addTerm(ColumnValue.fromString("1000")); //设置要匹配的值。
       searchQuery.setQuery(termsQuery);
       searchQuery.setGetTotalCount(true); //设置返回匹配的总行数。
       SearchRequest searchRequest = new SearchRequest("<TABLE_NAME>", "<SEARCH_INDEX_NAME>", searchQuery);
       SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
       columnsToGet.setReturnAll(true); //设置返回所有列，不支持返回虚拟列。
       searchRequest.setColumnsToGet(columnsToGet);
   
       SearchResponse resp = client.search(searchRequest);
       System.out.println("TotalCount: " + resp.getTotalCount()); //匹配到的总行数，非返回行数。
       System.out.println("Row: " + resp.getRows());
   }