klausa config - OpenSearch - Alibaba Cloud Documentation Center

Klausa config mengontrol paginasi, format respons, dan cakupan peringkat untuk hasil pencarian.

Parameter

Parameter	Tipe	Wajib	Nilai valid	Bawaan	Deskripsi
`start`	INT	Tidak	[0, 5000]	0	Offset dokumen pertama yang akan dikembalikan.
`hit`	INT	Tidak	[0, 500]	10	Jumlah maksimum dokumen per set hasil.
`format`	STRING	Tidak	`JSON`, `fullJSON`	`JSON`	Format respons. `fullJSON` mencakup dua bidang tambahan: `variableValue` dan `sortExprValues`.
`rerank_size`	INT	Tidak	[0, 2000]	200	Jumlah dokumen yang diteruskan ke ekspresi pengurutan presisi.
`total_rank_size`	INT	Tidak	—	—	Jumlah dokumen yang diteruskan ke ekspresi pengurutan kasar.
`default_operator`	STRING	Tidak	`AND`, `OR`	`AND`	Operator kueri bawaan. Hanya didukung untuk instans eksklusif.

Catatan penggunaan

Klausa config bersifat opsional.
Pisahkan pasangan kunci-nilai dengan koma (,). Pisahkan setiap kunci dan nilai dengan titik dua (:).
Jumlah dari start dan hit tidak boleh melebihi 5.000. Kueri yang melebihi batas ini akan mengembalikan error tanpa hasil. Batas ini diterapkan karena pengambilan jendela hasil yang dalam memerlukan pemuatan semua dokumen sebelumnya ke dalam memori, sehingga secara signifikan meningkatkan penggunaan sumber daya. Untuk melakukan paginasi lebih dari 5.000 dokumen, gunakan scroll search sebagai gantinya.
default_operator hanya didukung untuk instans eksklusif.
Sintaksis total_rank_size berbeda tergantung SDK yang Anda gunakan:
- Java SDK: config.addToCustomConfig("total_rank_size:200000");
- PHP SDK: $params->setCustomConfig('total_rank_size', 200000);
Untuk menyertakan detail pengurutan dalam respons, tambahkan format:fulljson ke klausa config. Bidang sortExprValues dalam respons merupakan array nilai bidang pengurutan yang sesuai dengan klausa sort. Sebagai contoh, dengan sort=-price;-RANK, sortExprValues mengembalikan [price, Document score]. Jika tidak ada klausa sort yang dikonfigurasi, sortExprValues secara bawaan mengembalikan skor dokumen.

Format respons: JSON vs fullJSON

Bidang	JSON	fullJSON
Bidang hasil standar	Ya	Ya
`variableValue`	—	Ya
`sortExprValues`	—	Ya

Gunakan fullJSON saat Anda perlu memeriksa skor pengurutan atau nilai ekspresi variabel per dokumen—misalnya, saat mendebug perilaku peringkat.

Contoh

Lakukan paginasi hasil — 20 dokumen per halaman

# Halaman 1
config=start:0, hit:20, format:xml

# Halaman 2
config=start:20, hit:20, format:xml

Dokumen sumber menggunakan format:xml dalam contoh paginasi ini. Namun, tabel Parameter hanya mencantumkan JSON dan fullJSON sebagai nilai format yang didukung. Ketidakkonsistenan ini terdapat pada dokumen sumber asli dan telah ditandai untuk ditinjau oleh tim produk.

Tetapkan pool kandidat pengurutan presisi menjadi 1.000 dokumen

config=start:0, hit:20, rerank_size:1000

Batasi pengurutan kasar hingga 100 dokumen

config=start:0, hit:20, total_rank_size:100

Langkah selanjutnya

Scroll searches — ambil lebih dari 5.000 dokumen di beberapa halaman