表格存储：虚拟列

前提条件

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

• 已创建数据表，并且数据表的最大版本数（max Versions）必须为1，数据生命周期（Time to Live）必须满足如下条件中的任意一个。具体操作，请参见创建数据表。

  • 数据表的数据生命周期为-1（数据永不过期）。

  • 数据表的数据生命周期不为-1时，数据表为禁止更新状态（即是否允许更新为否）。

注意事项

• 虚拟列支持不同类型到字符串类型的相互转换，转换规则请参见下表。

  数据表中字段类型	虚拟列字段类型
  String	Keyword（含数组）
  String	Text（含数组）
  String	Long（含数组）
  String	Double（含数组）
  String	Geo-point（含数组）
  Long	Keyword
  Long	Text
  Double	Keyword
  Double	Text

• 虚拟列目前仅支持用在查询语句中，不能用在ColumnsToGet返回列值，如果需要返回列值，可以指定返回该虚拟列的原始列。

参数

更多信息，请参见创建多元索引。

示例

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());
   }

相关文档

• 多元索引查询类型包括精确查询、多词精确查询、全匹配查询、匹配查询、短语匹配查询、前缀查询、范围查询、通配符查询、地理位置查询、向量检索、多条件组合查询、嵌套类型查询和列存在性查询，您可以选择合适的查询类型进行多维度数据查询。

  如果要对结果集进行排序或者翻页，您可以使用排序和翻页功能来实现。具体操作，请参见排序和翻页。

  如果要按照某一列对结果集做折叠，使对应类型的数据在结果展示中只出现一次，您可以使用折叠（去重）功能来实现。具体操作，请参见折叠（去重）。

• 如果要进行数据分析，例如求最值、求和、统计行数等，您可以使用Search接口的统计聚合功能或者SQL查询来实现。具体操作，请参见统计聚合和SQL查询。

• 如果要快速导出数据，而不关心整个结果集的顺序时，您可以使用ParallelScan接口和ComputeSplits接口实现多并发导出数据。具体操作，请参见并发导出数据。