Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Hasil Paginasi di Amazon CloudSearch
Secara default, Amazon CloudSearch mengembalikan sepuluh klik teratas sesuai dengan urutan pengurutan yang ditentukan. Untuk mengontrol jumlah klik yang dikembalikan dalam kumpulan hasil, Anda menggunakan size parameter.
Untuk mendapatkan set hit berikutnya yang dimulai dari offset tertentu, Anda dapat menggunakan start parameter. Perhatikan bahwa himpunan hasil berbasis nol — hasil pertama adalah pada indeks 0. Anda bisa mendapatkan 10.000 klik pertama menggunakan start parameter size dan. Untuk halaman melalui lebih dari 10.000 klik, gunakan cursor parameter. Untuk informasi selengkapnya, lihat Paging Dalam Melampaui 10.000 Hits .
Misalnya, search?q=wolverine mengembalikan 10 hit pertama yang berisi wolverine, dimulai dari indeks 0. Contoh berikut menetapkan start parameter ke 10 untuk mendapatkan set sepuluh hit berikutnya.
search?q=wolverine&start=10
Jika Anda ingin mengambil 25 klik sekaligus, atur size parameternya ke 25. Untuk mendapatkan set hit pertama, Anda tidak perlu mengatur start parameter.
search?q=wolverine&size=25
Untuk permintaan berikutnya, gunakan start parameter untuk mengambil set klik yang Anda inginkan. Misalnya, untuk mendapatkan batch ketiga dari 25 hits, tentukan yang berikut ini:
search?q=wolverine&size=25&start=50
Deep Paging Melampaui 10.000 Hits di Amazon CloudSearch
Menggunakan size dan start ke halaman melalui hasil bekerja dengan baik jika Anda hanya perlu mengakses beberapa halaman pertama hasil. Namun, jika Anda perlu halaman melalui ribuan klik, menggunakan kursor lebih efisien. Untuk halaman melalui lebih dari 10.000 klik, Anda harus menggunakan filecursor. (Anda hanya dapat mengakses 10.000 klik pertama menggunakan size parameter start dan.)
Untuk halaman melalui hasil menggunakan kursor, Anda menentukan cursor=initial dalam permintaan pencarian awal Anda dan menyertakan size parameter untuk menentukan berapa banyak klik yang ingin Anda dapatkan. Amazon CloudSearch mengembalikan nilai kursor dalam respons yang Anda gunakan untuk mendapatkan set klik berikutnya. Kursor mengembalikan set hit berurutan; Namun, Anda dapat menggunakannya untuk mensimulasikan akses acak halaman dalam jika perlu. Perlu diingat bahwa kursor dimaksudkan untuk digunakan ke halaman melalui hasil yang ditetapkan dalam jumlah waktu yang wajar dari permintaan awal. Menggunakan kursor basi dapat mengembalikan hasil basi jika pembaruan telah diposting ke indeks untuk sementara.
penting
Saat Anda menggunakan kursor ke halaman melalui kumpulan hasil yang diurutkan berdasarkan skor dokumen (_score), Anda bisa mendapatkan hasil yang tidak konsisten jika indeks diperbarui di antara permintaan. Ini juga dapat terjadi jika jumlah replikasi domain Anda lebih besar dari satu, karena pembaruan diterapkan secara konsisten di seluruh instance dalam domain. Jika ini menjadi masalah, hindari menyortir hasil berdasarkan skor. Anda dapat menggunakan sort opsi untuk mengurutkan berdasarkan bidang tertentu, atau menggunakan fq alih-alih q untuk menentukan kriteria pencarian Anda. (Skor dokumen tidak dihitung untuk kueri filter.)
Misalnya, permintaan berikut menetapkan cursor nilai ke initial dan size parameter 100 untuk mendapatkan set hit pertama.
search?q=-star&cursor=initial&size=100
Kursor untuk set hit berikutnya disertakan dalam respons.
{ "status": { "rid": "z67+3L0oHgo6swY=", "time-ms": 7 }, "hits": { "found": 1649, "start": 0, "cursor": "Vb-HSS4YQW9JSVFKeFpvQ2wwZERBek16SXpOems9Aw", "hit": [ { "id": "tt0397892" }, . . . { "id": "tt0332379" } ] } }
Dalam permintaan berikutnya, cursor parameter menentukan nilai kursor yang dikembalikan.
search?q=-star&cursor=Vb-HSS4YQW9JSVFKeFpvQ2wwZERBek16SXpOems9Aw&size=100
