クエリページング - config 句 - OpenSearch - Alibaba Cloud ドキュメントセンター

config 句は、返される最初のドキュメントの位置、返されるドキュメントの数、戻り結果のデータ形式、および高度ソート式でソートされるドキュメントの数などの構成を指定するために使用されます。

構文の説明

パラメーター	タイプ	必須	有効な値	デフォルト値	説明
start	int	いいえ	[0, 5000]	0	検索結果で返される最初のドキュメントの序数。
hit	int	いいえ	[0, 500]	10	返されるドキュメントの最大数。
format	string	いいえ		json	戻り結果のデータ形式。 JSON および fullJSON 形式がサポートされています。 JSON 形式と比較して、fullJSON 形式は、variableValue や sortExprValues などの追加フィールドをサポートしています。
rerank_size	int	いいえ	[0, 2000]	200	1 つの列に基づいて高度ソート式でソートされるドキュメントの数。
total_rank_size	int	いいえ	-	-	基本ソート式でソートされるドキュメントの数。
total_rerank_size	int	いいえ	[0,10000]	-	高度ソート式でソートされるドキュメントの数。
default_operator	string	いいえ	'AND' または 'OR'	AND	このクエリで使用されるデフォルトのクエリ演算子。注: このパラメーターは、専用インスタンスでのみサポートされています。

使用上の注意

config 句はオプションです。
パラメーターのキーと値のペアはコンマ (,) で区切ります。
各パラメーターのキーと値はコロン (:) で区切ります。
start パラメーターと hit パラメーターの値の合計が 5,000 を超えないようにしてください。超えた場合はエラーが発生し、結果は返されません。複数のページで 5,000 を超えるデータエントリを取得する必要がある場合は、スクロール検索を実行してドキュメントを一度にエクスポートし、ページングを実装できます。詳細については、「スクロール検索」をご参照ください。
default_operator パラメーターは、専用インスタンスでのみサポートされています。
total_rank_size パラメーターは、さまざまな言語の OpenSearch SDK で異なる形式で指定されます。 OpenSearch SDK for Java では、このパラメーターを config.addToCustomConfig("total_rank_size:200000"); の形式で指定します。 OpenSearch SDK for PHP では、このパラメーターを $params->setCustomConfig('total_rank_size', 200000); の形式で指定します。
コードにパラメーターを追加することで、ドキュメントのソートの詳細を表示できます。
方法: format:fulljson パラメーターを config 句に追加します。
返された結果では、sortExprValues パラメーターはドキュメントのソート情報を示します。
```
"sortExprValues": [
					"10000.0340123586"
				]
```
sortExprValues パラメーターの値は配列であり、sort 句のソートフィールドの値です。例:
```
sort=-price;-RANK
```
この場合、sortExprValues パラメーターの値は [価格, ドキュメントスコア] の形式になります。
sort 句を構成しない場合、sortExprValues パラメーターの値はデフォルトでドキュメントスコアになります。

例

ページングを構成します。この例では、各ページに 20 個のドキュメントが返されます。

# 最初のページの config 句。
config=start:0, hit:20, format:json   
# 2 番目のページの config 句。
config=start:20, hit:20, format:json

高度ソート式でソートされるドキュメントの数を 1000 に設定します。
```
config=start:0, hit:20, rerank_size:1000
```
取得されるドキュメントの最大数を 100 に設定します。
```
config=start:0, hit:20, total_rank_size:100
```