Exists クエリは、NULL クエリまたは NULL 値クエリとも呼ばれます。このクエリは、スパースデータで使用され、行の列が存在するかどうかを判断します。たとえば、住所列の値が空でない行をクエリできます。
Nested 列に対して Exists クエリを実行する場合は、ネストクエリを使用できます。
列に空の値が含まれているかどうかを確認する場合は、BoolQuery の mustNotQueries と共に ExistsQuery を使用する必要があります。
次のいずれかの条件が満たされている場合、システムは列が存在しないと見なします。この例では、city 列が使用されています。
検索インデックスの city 列のタイプが、keyword などの基本タイプである場合。データテーブルに city 列が存在しない行がある場合、検索インデックスは city 列が存在しないと見なします。
検索インデックスの city 列のタイプが、keyword などの基本タイプである場合。データテーブルの city 列の値が空の配列である行 ("city" = "[]") がある場合、検索インデックスは city 列が存在しないと見なします。
前提条件
OTSClient インスタンスが初期化されていること。詳細については、OTSClient インスタンスの初期化を参照してください。
データテーブルが作成され、データがデータテーブルに書き込まれていること。詳細については、データテーブルの作成およびデータの書き込みを参照してください。
データテーブルの検索インデックスが作成されていること。詳細については、検索インデックスの作成を参照してください。
パラメーター
パラメーター | 説明 |
fieldName | クエリ対象の列の名前。 |
query | クエリタイプ。このパラメーターを ExistsQuery に設定します。 |
getTotalCount | クエリ条件を満たす行の総数を返すかどうかを指定します。このパラメーターのデフォルト値は false で、クエリ条件を満たす行の総数は返されません。 このパラメーターを true に設定すると、クエリのパフォーマンスが低下します。 |
tableName | データテーブルの名前。 |
indexName | 検索インデックスの名前。 |
columnsToGet | クエリ条件を満たす各行のすべての列を返すかどうかを指定します。このパラメーターには、returnAll フィールドと columns フィールドを設定できます。 returnAll フィールドのデフォルト値は false で、すべての列が返されるわけではありません。この場合、columns フィールドを使用して、返す列を指定できます。返す列を指定しない場合は、プライマリキー列のみが返されます。 returnAll フィールドを true に設定すると、すべての列が返されます。 |
例
次のサンプルコードは、指定された列が空でないすべての行をクエリする方法の例を示しています。
public static void existQuery(SyncClient syncClient) {
// col_keyword フィールドが存在するかどうかをクエリします。 col_keyword フィールドは Nested フィールドではありません。
{
{
// 次のサンプルコードは、Nested タイプではないフィールドが存在するかどうかをクエリする方法の例を示しています。
SearchQuery searchQuery = new SearchQuery();
ExistsQuery existQuery = new ExistsQuery(); // クエリタイプを ExistsQuery に設定します。
existQuery.setFieldName("col_keyword");
searchQuery.setQuery(existQuery);
SearchRequest searchRequest = new SearchRequest("<TABLE_NAME>", "<SEARCH_INDEX_NAME>", searchQuery);
SearchResponse resp = syncClient.search(searchRequest);
}
{
// ビルダーを構築します。
SearchResponse resp = syncClient.search(SearchRequest.newBuilder()
.indexName("<SEARCH_INDEX_NAME>")
.tableName("<TABLE_NAME>")
.searchQuery(
SearchQuery.newBuilder()
.query(QueryBuilders.exists("col_keyword"))
.limit(10)
.build())
.build());
}
}
// Nested 構造は [{"keyword":"a","long":123}] です。
{
// col_nested 親フィールドが存在するかどうかをクエリします。 col_nested フィールドは Nested タイプです。
{
SearchResponse resp = syncClient.search(SearchRequest.newBuilder()
.indexName("<SEARCH_INDEX_NAME>")
.tableName("<TABLE_NAME>")
.searchQuery(
SearchQuery.newBuilder()
.query(QueryBuilders.nested()
.scoreMode(ScoreMode.None)
.path("col_nested")
.query(QueryBuilders.exists("col_nested")))
.limit(10)
.getTotalCount(false)
.build())
.build());
}
// col_nested.keyword フィールドが存在するかどうかをクエリします。 col_nested.keyword フィールドは Nested タイプです。
{
SearchResponse resp = syncClient.search(SearchRequest.newBuilder()
.indexName("<SEARCH_INDEX_NAME>")
.tableName("<TABLE_NAME>")
.searchQuery(
SearchQuery.newBuilder()
.query(QueryBuilders.nested()
.scoreMode(ScoreMode.None)
.path("col_nested")
.query(QueryBuilders.exists("col_nested.keyword")))
.limit(10)
.getTotalCount(false)
.build())
.build());
}
}
}FAQ
関連情報
検索インデックスを使用してデータをクエリする場合、次のクエリメソッドを使用できます。タームクエリ、タームズクエリ、マッチオールクエリ、マッチクエリ、マッチフレーズクエリ、プレフィックスクエリ、範囲クエリ、ワイルドカードクエリ、ジオクエリ、KNNベクトル検索クエリ、ブールクエリ、ネストクエリ、Exists クエリ。検索インデックスを作成した後、検索インデックスで提供されるクエリメソッドを使用して、ビジネス要件に基づいて複数のディメンションからデータをクエリできます。
並べ替え機能とページング機能を使用して、クエリ条件を満たす行を並べ替えたりページ分割したりできます。詳細については、並べ替えとページングの実行を参照してください。
折りたたみ（重複排除）機能を使用して、特定の列に基づいて結果セットを折りたたむことができます。このようにして、指定されたタイプのデータはクエリ結果に一度だけ表示されます。詳細については、折りたたみ（重複排除）を参照してください。
テーブル内のデータを分析する場合は、Search 操作を呼び出して集計機能を使用するか、SQL クエリ機能を使用できます。たとえば、最大値と最小値、値の合計、行数をクエリできます。詳細については、集計およびSQL クエリを参照してください。
行を並べ替えることなく、クエリ条件を満たすすべての行を取得する場合は、ParallelScan 操作と ComputeSplits 操作を呼び出して並列スキャン機能を使用できます。詳細については、並列スキャンを参照してください。