.NET SDK多词精确查询-表格存储 Tablestore(Tablestore)-阿里云帮助中心

多词精确查询（TermsQuery）类似于精确查询（TermQuery），但是TermsQuery可以指定多个查询关键词，查询匹配这些词的数据。多个查询关键词中只要有一个词能精确匹配，该行数据就会被返回，等价于SQL中的In。

前提条件

已初始化OTSClient。具体操作，请参见初始化Tablestore Client。
已创建数据表并写入数据。具体操作，请参见创建数据表和写入数据。
已在数据表上创建多元索引。具体操作，请参见创建多元索引。

参数

参数	说明
TableName	数据表名称。
IndexName	多元索引名称。
Query	查询类型，设置为 TermsQuery。
FieldName	目标匹配字段名称。
Terms	查询关键词列表。字段值与任意一个关键词精确匹配，该行数据即被返回。
Limit	返回结果的最大行数。设置为 0 时只返回匹配行数，不返回具体数据。
ColumnsToGet	指定返回的列，通过 ReturnAll、Columns 或 ReturnAllFromIndex 配置。 ReturnAll 默认为 false，仅返回主键列。如需返回其他列，可通过以下方式配置：设置 Columns，指定返回的列名。设置 ReturnAllFromIndex 为 true，返回多元索引中的所有列。设置 ReturnAll 为 true，返回数据表中的所有列。

示例

以下示例查询 Col_Keyword 列精确匹配 "SearchIndex" 或 "Sample" 的数据。

/// <summary>
/// 查询 Col_Keyword 列精确匹配 "SearchIndex" 或 "Sample" 的数据。
/// </summary>
/// <param name="otsClient"></param>
public static void TermsQuery(OTSClient otsClient)
{
    TermsQuery termsQuery = new TermsQuery();
    termsQuery.FieldName = "Col_Keyword";
    termsQuery.Terms = new List<ColumnValue>
    {
        new ColumnValue("SearchIndex"),
        new ColumnValue("Sample")
    };

    SearchQuery searchQuery = new SearchQuery();
    searchQuery.Query = termsQuery;

    SearchRequest searchRequest = new SearchRequest(TableName, IndexName, searchQuery);
    // 通过 ColumnsToGet 指定返回列：多元索引所有列、指定列名或数据表所有列。
    // 不设置时默认只返回主键列。
    searchRequest.ColumnsToGet = new ColumnsToGet
    {
        // 返回多元索引中的所有列。
        ReturnAllFromIndex = true
        // 返回指定列。
        //Columns = new List<string>() { Long_type_col, Text_type_col, Keyword_type_col }
        // 返回数据表中的所有列。
        //ReturnAll = true         
    };

    SearchResponse searchResponse = otsClient.Search(searchRequest);

    Console.WriteLine(JsonConvert.SerializeObject(searchResponse));
}

多词精确查询

前提条件

参数

示例

常见问题

相关文档