Referensi klausa konfigurasi untuk kontrol kueri pencarian - OpenSearch

Klausa config digunakan untuk menentukan konfigurasi seperti offset, jumlah dokumen, format data hasil yang dikembalikan, serta jumlah dokumen yang akan diurutkan oleh ekspresi pengurutan halus.

Parameter

Parameter	Tipe	Wajib	Nilai valid	Nilai default	Deskripsi
start	INT	Tidak	[0, 5000]	0	Nomor urut dokumen pertama yang akan dikembalikan dalam hasil pencarian.
hit	INT	Tidak	[0, 500]	10	Jumlah maksimum dokumen dalam setiap set hasil.
format	STRING	Tidak		JSON	Format data hasil yang dikembalikan. Format yang didukung adalah JSON dan fullJSON. Dibandingkan dengan format JSON, format fullJSON mendukung bidang tambahan seperti variableValue dan sortExprValues.
rerank_size	INT	Tidak	[0, 2000]	200	Jumlah dokumen yang akan diurutkan oleh ekspresi pengurutan halus.
total_rank_size	INT	Tidak	-	-	Jumlah dokumen yang akan diurutkan oleh ekspresi pengurutan kasar.
default_operator	STRING	Tidak	'AND' atau 'OR'	AND	Operator kueri default yang digunakan dalam kueri ini. Catatan: Parameter ini hanya didukung untuk instance eksklusif.

Catatan Penggunaan

Klausa config bersifat opsional.
Pisahkan pasangan nilai kunci parameter dengan koma (,).
Pisahkan kunci dan nilai setiap parameter dengan titik dua (:).
Pastikan bahwa jumlah dari nilai start dan hit tidak melebihi 5.000. Jika tidak, akan terjadi kesalahan dan tidak ada hasil yang dikembalikan. Untuk mendapatkan lebih dari 5.000 entri data di beberapa halaman, gunakan pencarian gulir untuk mengekspor dokumen sekaligus dan mengimplementasikan paging. Untuk informasi lebih lanjut, lihat Pencarian Gulir.
Parameter default_operator hanya didukung untuk instance eksklusif.
Parameter total_rank_size ditentukan dalam format berbeda di OpenSearch SDK untuk bahasa yang berbeda. Di OpenSearch SDK untuk Java, tentukan parameter ini dalam format berikut: config.addToCustomConfig("total_rank_size:200000");. Di OpenSearch SDK untuk PHP, tentukan parameter ini dalam format berikut: $params->setCustomConfig('total_rank_size', 200000);.
Anda dapat melihat detail pengurutan dokumen dengan menambahkan parameter ke kode Anda.
Metode: Tambahkan parameter format:fulljson ke klausa config.
Dalam hasil yang dikembalikan, parameter sortExprValues menunjukkan informasi pengurutan dokumen.
Nilai dari parameter sortExprValues adalah array, yang merupakan nilai dari bidang sort dalam klausa sort. Contoh:
```
sort=-price;-RANK
```
Dalam hal ini, nilai dari parameter sortExprValues berada dalam format [harga, Skor Dokumen].
Jika Anda tidak mengonfigurasi klausa sort, nilai dari parameter sortExprValues adalah skor dokumen secara default.

Contoh

Gunakan klausa config untuk mengonfigurasi paging. Dalam contoh ini, setiap halaman hasil yang dikembalikan menampilkan 20 dokumen.

# Klausa config untuk halaman pertama.
config=start:0, hit:20, format:xml   
# Klausa config untuk halaman kedua.
config=start:20, hit:20, format:xml

Atur jumlah dokumen yang akan diurutkan oleh ekspresi pengurutan halus menjadi 1.000.
```
config=start:0, hit:20, rerank_size:1000
```
Atur jumlah maksimum dokumen yang akan diambil menjadi 100.
```
config=start:0, hit:20, total_rank_size:100
```