全部產品
Search
文件中心

:列存在性查詢

更新時間:Jul 19, 2024

ExistsQuery也叫NULL查詢或者空值查詢,一般用於判斷稀疏資料中某一行的某一列是否存在。例如查詢所有資料中address列不為空白的行。

說明
  • 要對Nested欄位進行列存在性查詢(ExistsQuery)時,請使用巢狀型別查詢(NestedQuery)進行嵌套。

  • 如果需要查詢某一列為空白,則ExistsQuery需要和BoolQuery中的mustNotQueries結合使用。

  • 以下情況會認為某一列不存在,以city列為例說明。

    • city列在多元索引中的資料類型為keyword(或其他基礎類型),如果資料表中某行資料不存在city列,則多元索引認為該行資料的city列不存在。

    • city列在多元索引中的資料類型為keyword(或其他基礎類型)數組,如果資料表中某行資料的city列為空白數組,即"city" = "[]",則多元索引認為該行資料的city列不存在。

前提條件

參數

參數

說明

TableName

資料表名稱。

IndexName

多元索引名稱。

Query

設定查詢類型為existsQuery。

GetTotalCount

是否返回匹配的總行數,預設為false,表示不返回。

返回匹配的總行數會影響查詢效能。

FieldName

要匹配的欄位。

ColumnsToGet

是否返回所有列。包含ReturnAll和Columns以及ReturnAllFromIndex設定。

ReturnAll預設為false,表示不返回所有列。此時可以通過如下任一設定返回所需列。如果未設定Columns和ReturnAllFromIndex,則只返回主鍵列。

  • 設定Columns指定返回的列。

  • 設定ReturnAllFromIndex為true返回多元索引中的所有列。

當設定ReturnAll為true時,表示返回所有列。

樣本

以下樣本用於查詢所有資料中指定列不為空白的行。

/// <summary>
/// 使用列存在性查詢,查詢表中pk0列的值不為空白的資料。
/// </summary>
/// <param name="otsClient"></param>
public static void ExistsQuery(OTSClient otsClient)
{
    ExistsQuery existsQuery = new ExistsQuery
    {
        FieldName = "pk0"
    };

    SearchQuery searchQuery = new SearchQuery
    {
        Query = existsQuery,
        GetTotalCount = false
    };

    SearchRequest searchRequest = new SearchRequest(TableName, IndexName, searchQuery);
    SearchResponse searchResponse = otsClient.Search(searchRequest);

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

常見問題

相關文檔