Exists クエリは、NULL クエリまたは NULL 値クエリとも呼ばれます。このクエリは、スパースデータで使用され、行の列が存在するかどうかを判断します。たとえば、住所列の値が空でない行をクエリできます。
Nested 列に対して Exists クエリを実行する場合は、ネストクエリを使用できます。
列に空の値が含まれているかどうかを確認するには、ExistsQuery を BoolQuery の mustNotQueries と共に使用する必要があります。
次のいずれかの条件が満たされている場合、システムは列が存在しないと見なします。この例では、city 列が使用されています。
検索インデックス内の city 列のタイプが、keyword などの基本タイプである場合。データテーブルに city 列が存在しない行がある場合、検索インデックスは city 列が存在しないと見なします。
検索インデックス内の city 列のタイプが、keyword などの基本タイプである場合。データテーブル内の city 列の値が空の配列である行（"city" = "[]"）がある場合、検索インデックスは city 列が存在しないと見なします。
前提条件
OTSClient インスタンスが初期化されていること。詳細については、OTSClient インスタンスの初期化を参照してください。
データテーブルが作成され、データがデータテーブルに書き込まれていること。詳細については、データテーブルの作成とデータの書き込みを参照してください。
データテーブルの検索インデックスが作成されていること。詳細については、検索インデックスの作成を参照してください。
パラメーター
パラメーター | 説明 |
fieldName | 一致させるフィールドの名前。 |
query | クエリタイプ。Exists クエリを使用するには、このパラメーターを TableStore.QueryType.EXISTS_QUERY に設定します。 |
getTotalCount | クエリ条件を満たす行の総数を返すかどうかを指定します。デフォルト値: false。 このパラメーターを true に設定すると、クエリのパフォーマンスが低下します。 |
tableName | データテーブルの名前。 |
indexName | 検索インデックスの名前。 |
columnsToGet | クエリ条件を満たす各行のすべての列を返すかどうかを指定します。
|
例
次のサンプルコードは、指定された列が空でない行をクエリする方法の例を示しています。
client.search({
tableName: TABLE_NAME,
indexName: INDEX_NAME,
searchQuery: {
offset: 0,
limit: 10, // 特定のデータなしでクエリ条件を満たす行の数のみをクエリするには、limit パラメーターを 0 に設定します。
query: {
queryType: TableStore.QueryType.EXISTS_QUERY,
query: {
fieldName: "pic_des"
},
},
getTotalCount: true // クエリ条件を満たす行の総数を返すかどうかを指定します。デフォルト値: false。
},
columnToGet: { // 返す列を指定します。RETURN_SPECIFIED を設定して指定した列を返すか、RETURN_ALL を設定してすべての列を返すか、RETURN_ALL_FROM_INDEX を設定して検索インデックス内のすべての列を返すか、RETURN_NONE を設定してプライマリキー列のみを返すことができます。
returnType: TableStore.ColumnReturnType.RETURN_SPECIFIED,
returnNames: ["Col_1", "Col_2", "Col_3"]
}
}, function (err, data) {
if (err) {
console.log('error:', err);
return;
}
console.log('success:', JSON.stringify(data, null, 2));
});FAQ
関連情報
検索インデックスでは、次のクエリタイプがサポートされています。タームクエリ、タームズクエリ、すべてに一致クエリ、一致クエリ、一致フレーズクエリ、プレフィックスクエリ、範囲クエリ、ワイルドカードクエリ、ブールクエリ、ジオクエリ、ネストクエリ、ベクタークエリ、Exists クエリ。ビジネス要件に基づいてクエリタイプを選択してデータをクエリできます。
クエリ条件を満たす行をソートまたはページングする場合は、ソートおよびページング機能を使用できます。詳細については、ソートとページングを参照してください。
特定の列に基づいて結果セットを折りたたむ場合は、折りたたみ（重複排除）機能を使用できます。このようにして、指定されたタイプのデータはクエリ結果に一度だけ表示されます。詳細については、折りたたみ（重複排除）を参照してください。
データテーブル内のデータ（極値、合計、行の総数など）を分析する場合は、集計操作を実行するか、SQL ステートメントを実行できます。詳細については、集計とSQL クエリを参照してください。
行をソートする必要なく、クエリ条件を満たすすべての行をすばやく取得する場合は、ParallelScan および ComputeSplits 操作を呼び出して並列スキャン機能を使用できます。詳細については、並列スキャンを参照してください。