複数値完全一致検索は、完全一致検索と似ています。複数値完全一致検索では複数のキーワードを指定できます。列の値がいずれか 1 つのキーワードに一致する場合、そのデータ行が返されます。複数値完全一致検索は、SQL ステートメントにおける IN 演算子と同様に使用できます。
API オペレーション
Search オペレーションまたは ParallelScan オペレーションを呼び出し、クエリタイプを TermsQuery に設定することで、複数値完全一致検索を実行できます。
パラメーター
パラメーター | 説明 |
query | クエリのタイプです。このパラメーターを TermsQuery に設定します。 |
fieldName | 一致させたいフィールドの名前です。 |
terms |
一致させる検索語です。最大 1,024 個の語を指定できます。 列の値がいずれか 1 つのキーワードに一致する場合、そのデータ行が返されます。 |
getTotalCount | クエリ条件を満たす行の総数を返すかどうかを指定します。デフォルト値は false で、クエリ条件を満たす行の総数は返されません。 このパラメーターを true に設定すると、クエリのパフォーマンスが低下します。 |
weight | BM25 ベースのキーワード関連性スコアを計算するために、クエリ対象フィールドに割り当てる重みです。このパラメーターは全文検索のシナリオで使用されます。クエリ対象フィールドに高い重みを指定すると、そのフィールドの BM25 ベースのキーワード関連性スコアが高くなります。このパラメーターの値は正の浮動小数点数です。 このパラメーターは返される行数には影響しませんが、クエリ結果の BM25 ベースのキーワード関連性スコアには影響します。 |
tableName | データテーブルの名前です。 |
indexName | 検索インデックスの名前。 |
columnsToGet | クエリ条件を満たす各行のすべての列を返すかどうかを指定します。このパラメーターでは returnAll フィールドと columns フィールドを指定できます。 returnAll フィールドのデフォルト値は false で、すべての列が返されないことを意味します。この場合、columns フィールドを使用して返したい列を指定できます。返したい列を指定しない場合は、プライマリキー列のみが返されます。 returnAll フィールドを true に設定すると、すべての列が返されます。 |
方法
Tablestore コンソール、Tablestore CLI、または Tablestore SDK を使用して複数値完全一致検索を実行できます。複数値完全一致検索を実行する前に、以下の事前準備を完了させてください。
Tablestore の操作権限を持つ Alibaba Cloud アカウントまたは RAM ユーザーを用意します。RAM ユーザーに Tablestore の操作権限を付与する方法については、「RAM ポリシーを使用して RAM ユーザーに権限を付与する」をご参照ください。
Tablestore SDK または Tablestore CLI を使用してクエリを実行する場合は、ご利用の Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ペアを作成してください。詳細については、「AccessKey ペアの作成」をご参照ください。
データテーブルを作成します。詳細については、「テーブルの操作」をご参照ください。
データテーブルに対して多次元インデックスを作成します。詳細については、「多次元インデックスの作成」をご参照ください。
Tablestore SDK を使用してクエリを実行する場合は、OTSClient インスタンスを初期化します。詳細については、「OTSClient インスタンスの初期化」をご参照ください。
Tablestore CLI を使用してクエリを実行する場合は、Tablestore CLI をダウンロードして起動し、アクセスするインスタンスの情報を設定します。詳細については、「Tablestore CLI のダウンロード」および「Tablestore CLI の起動とアクセス情報の設定」をご参照ください。
課金
多次元インデックスを使用してデータをクエリすると、読み取りスループットが消費されます。詳細については、「多次元インデックスのメータリングと課金」をご参照ください。
よくある質問
関連ドキュメント
多次元インデックスは、多次元データクエリ向けにさまざまなクエリタイプをサポートしています。これには、完全一致検索、複数値完全一致検索、完全一致検索、一致検索、フレーズ一致検索、範囲クエリ、プレフィックス検索、サフィックス検索、ワイルドカード検索、トークンベースのワイルドカード検索、ブール検索、ジオクエリ、ネストされたクエリ、ベクトル検索、および 存在検索 が含まれます。
データをクエリする際には、結果セットをソートおよびページネーションしたり、重複排除を実行したりできます。
最大値や最小値の検索、合計の計算、行数のカウントなどのデータ分析を行うには、統計的集約機能または SQL クエリ 機能を使用できます。
結果セットの順序を問わずデータを高速にエクスポートするには、Parallel Scan 機能を使用できます。