すべてのプロダクト
Search
ドキュメントセンター

Tablestore:SearchQuery

最終更新日:Nov 09, 2025

SearchQuery は、多次元インデックスの Search 操作を呼び出すときに指定するクエリ構成を指定します。

データ構造

message SearchQuery {
    optional int32 offset = 1;
    optional int32 limit = 2;
    optional Query query = 4;
    optional Collapse collapse = 5;
    optional Sort sort = 6;
    optional bool getTotalCount = 8;
    optional bytes token = 9;
    optional Aggregations aggs = 10;
    optional GroupBys group_bys = 11;
    optional Highlight highlight = 12;
    optional SearchFilter filter = 14;
}

名前

必須

説明

offset

int32

いいえ

現在のクエリが開始される位置です。

limit

int32

いいえ

現在のクエリで返される最大行数です。

query

Query

はい

クエリ構成。

collapse

Collapse

いいえ

指定された列に基づいて返された結果を折りたたみます。

sort

Sort

いいえ

結果のソート方法です。

getTotalCount

bool

いいえ

クエリ条件を満たす行の総数を返すかどうかを指定します。このパラメーターのデフォルト値は false で、クエリ条件を満たす行の総数は返されません。

一致した行の総数を返すと、クエリのパフォーマンスが低下します。

token

bytes

いいえ

Tablestore がクエリ条件を満たすすべてのデータを読み取れない場合、Tablestore は next_token を返します。 next_token を使用して後続のデータの読み取りを続行できます。

aggs

Aggregations

いいえ

集約の構成です。

group_bys

GroupBys

いいえ

グループ化の構成です。

highlight

Highlight

いいえ

ハイライトの構成です。

filter

SearchFilter

いいえ

クエリフェーズのポストフィルター。フィルターはクエリの結果に適用されます。集約とグループ化は、フィルター処理されたデータに対してのみ実行されます。

関連操作

Search