テーブル内のすべての行を照合して、テーブルの合計行数を照会したり、複数のランダムな行を返したりするには、Match all queryを使用できます。
API操作
SearchまたはParallelScan操作を呼び出し、クエリタイプをMatchAllQueryに設定して、Match all queryを実行できます。
パラメーター
パラメーター | 説明 |
query | クエリのタイプ。queryパラメーターをMatchAllQueryに設定します。 |
tableName | データテーブルの名前。 |
indexName | 検索インデックスの名前。 |
limit | 現在のクエリで返す最大行数。 現在のクエリで複数のランダムなデータ行を返す場合は、limitパラメーターを正の整数に設定します。 クエリ条件を満たす行数を特定のデータなしで照会するには、limitパラメーターを0に設定します。 |
columnsToGet | クエリ条件を満たす各行のすべての列を返すかどうかを指定します。columnsToGetパラメーターには、returnAllフィールドとcolumnsフィールドを指定できます。 returnAllフィールドのデフォルト値はfalseで、すべての列が返されないことを指定します。この場合、columnsフィールドを使用して、返す列を指定できます。返す列を指定しない場合は、プライマリキー列のみが返されます。 returnAllフィールドをtrueに設定すると、すべての列が返されます。 |
getTotalCount | クエリ条件を満たす行の総数を返すかどうかを指定します。このパラメーターのデフォルト値はfalseで、クエリ条件を満たす行の総数は返されません。 このパラメーターをtrueに設定すると、クエリのパフォーマンスが低下します。 |
メソッド
Tablestore CLIまたはTablestore SDKを使用して、Match all queryを実行できます。Match all queryを実行する前に、以下の準備が完了していることを確認してください。
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を起動し、アクセス情報を構成する、およびデータテーブルの操作を参照してください。
課金ルール
検索インデックスを使用してデータを照会する場合、消費された読み取りスループットに対して課金されます。詳細については、検索インデックスの課金対象項目を参照してください。
FAQ
参考資料
検索インデックスを使用してデータを照会する場合、次のクエリメソッドを使用できます。タームクエリ、タームズクエリ、Match all query、マッチクエリ、マッチフレーズクエリ、プレフィックスクエリ、範囲クエリ、ワイルドカードクエリ、あいまいクエリ、ブールクエリ、ジオクエリ、ネストされたクエリ、KNNベクトル検索、およびExistsクエリ。ビジネス要件に基づいてクエリメソッドを選択し、複数のディメンションからデータを照会できます。
ソート機能とページング機能を使用して、クエリ条件を満たす行をソートまたはページングできます。詳細については、ソートとページングを実行するを参照してください。
Collapse(Distinct)機能を使用して、特定の列に基づいて結果セットを折りたたむことができます。このようにして、指定されたタイプのデータはクエリ結果に1回だけ表示されます。詳細については、Collapse(Distinct)を参照してください。
データテーブルのデータを分析する場合は、Search操作の集計機能を使用するか、SQLステートメントを実行できます。たとえば、最小値、最大値、合計、および行の総数を取得できます。詳細については、集計およびSQLクエリを参照してください。
行をソートする必要なく、クエリ条件を満たすすべての行を取得する場合は、ParallelScan操作とComputeSplits操作を呼び出して、パラレル スキャン機能を使用できます。詳細については、パラレル スキャンを参照してください。