多詞精確查詢

多詞精確查詢（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));
}

多詞精確查詢

前提條件

參數

樣本

常見問題

相關文檔