

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
<a name="paginating-results"></a>

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 ](#deep-paging).

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
<a name="deep-paging"></a>

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 file`cursor`. (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
```