

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Langkah 3: Cari CloudSearch Domain Amazon Anda
<a name="getting-started-search"></a>

Anda dapat menggunakan penguji penelusuran di CloudSearch konsol Amazon untuk mengirimkan contoh permintaan pencarian dan melihat hasilnya. Anda juga dapat mengirimkan contoh permintaan pencarian melalui browser Web atau menggunakan cURL. Dalam aplikasi Anda, Anda dapat menggunakan perpustakaan HTTP apa pun untuk mengirim lalu lintas pencarian ke CloudSearch domain Amazon Anda.

## Mencari dengan Search Tester
<a name="searching-console"></a>

Penguji penelusuran di CloudSearch konsol Amazon memungkinkan Anda mengirimkan contoh permintaan pencarian menggunakan salah satu parser kueri yang didukung: sederhana, terstruktur, lucene, atau dismax. Secara default, permintaan diproses dengan parser kueri sederhana. Anda dapat menentukan opsi untuk parser yang dipilih, memfilter dan mengurutkan hasil, dan menelusuri aspek yang dikonfigurasi. Hit pencarian secara otomatis disorot dalam hasil pencarian. Untuk informasi tentang bagaimana hal ini dilakukan, lihat[Menyoroti Pencarian Hits di Amazon CloudSearch](highlighting.md). Anda juga dapat memilih pemberi saran untuk mendapatkan saran saat memasukkan istilah di bidang **Pencarian**. (Anda harus mengonfigurasi sugester sebelum Anda bisa mendapatkan saran. Untuk informasi lebih lanjut lihat[Mendapatkan Saran Pelengkapan Otomatis di Amazon CloudSearch](getting-suggestions.md).)

*Secara default, hasil diurutkan menurut skor relevansi yang dihasilkan secara otomatis, \$1score.* Untuk informasi tentang menyesuaikan bagaimana hasil diberi peringkat, lihat[Menyortir Hasil di Amazon CloudSearch](sorting-results.md).

**Untuk mencari domain Anda**

1. Pergi ke CloudSearch konsol Amazon di [https://console.aws.amazon.com/cloudsearch/rumah](https://console.aws.amazon.com/cloudsearch/home).

1. Di panel navigasi kiri, pilih domain **film** Anda untuk membuka konfigurasinya.

1. Pilih **Jalankan pencarian pengujian**.

1. Untuk melakukan pencarian teks sederhana, masukkan kueri penelusuran dan pilih **Jalankan**. Secara default, semua `text` dan `text-array` bidang dicari. 

Untuk mencari bidang tertentu, perluas **Opsi** dan masukkan daftar bidang yang dipisahkan koma yang ingin Anda cari di bidang bidang **Penelusuran**. Anda dapat menambahkan bobot ke setiap bidang dengan tanda sisipan (^) untuk mengontrol kepentingan relatif setiap bidang dalam hasil pencarian. Misalnya, menentukan hit `title^5, description` bobot di `title` lapangan lima kali lebih banyak daripada hit di `description` lapangan saat menghitung skor relevansi untuk setiap dokumen yang cocok.

Untuk menggunakan sintaks kueri terstruktur, pilih **Structured** dari menu **Query parser**. Setelah Anda memilih parser kueri terstruktur, masukkan kueri terstruktur Anda di bidang **Pencarian** dan pilih **Jalankan**. Misalnya, untuk menemukan semua film dengan *bintang* dalam judul yang dirilis pada tahun 2000 atau sebelumnya, Anda dapat memasukkan:`(and title:'star' year:{,2000])`. Untuk informasi selengkapnya, lihat [Membangun Kueri Senyawa](searching-compound-queries.md). Untuk mengirimkan Lucene atau DisMax kueri, pilih parser kueri yang sesuai.

Anda dapat menentukan opsi tambahan untuk parser kueri yang dipilih untuk mengonfigurasi operator default dan mengontrol operator mana yang dapat digunakan dalam kueri. Untuk informasi selengkapnya, lihat [Parameter Permintaan Pencarian](search-api.md#search-request-parameters).

Anda dapat menyalin dan menempelkan URL permintaan untuk mengirimkan permintaan dan melihat respons dari browser Web. Permintaan dapat dikirim melalui HTTP atau HTTPS.

## Mengirimkan Permintaan Pencarian dari Browser Web
<a name="searching-browser"></a>

Anda dapat mengirimkan permintaan pencarian langsung ke titik akhir pencarian Anda dari browser Web apa pun. Anda dapat menggunakan salah satu parser kueri (sederhana, terstruktur, lucene, atau dismax) dan menentukan berbagai opsi untuk membatasi pencarian Anda, meminta informasi aspek, menyesuaikan peringkat, dan mengontrol informasi apa yang dikembalikan dalam hasil. 

Misalnya, untuk mencari domain film Anda dan mendapatkan judul semua film *Star Wars* yang tersedia, tambahkan string pencarian berikut ke titik akhir pencarian Anda. (2013-01-01 adalah versi API dan harus ditentukan.)

**Example**  

```
/2013-01-01/search?q=star+wars&return=title
```

**catatan**  
Titik akhir pencarian domain Anda ditampilkan di dasbor domain. Anda juga dapat melakukan pencarian dari AWS Management Console, melihat permintaan dan respons mentah, dan menyalin URL permintaan dari bidang Permintaan Pencarian. Endpoint pencarian dan layanan dokumen domain tetap sama selama masa pakai domain.

Secara default, Amazon CloudSearch mengembalikan respons di JSON. Anda juga bisa mendapatkan hasil pencarian diformat dalam XHTML dengan menentukan parameter,`format`. `format=xml` (Perhatikan bahwa kesalahan dapat dikembalikan dalam JSON atau XHTML, tergantung dari mana kesalahan berasal.) 

## Mencari Bidang Numerik
<a name="getting-started-searching-numeric-fields"></a>

 Anda dapat menggunakan sintaks kueri terstruktur,`q.parser=structured`, untuk menemukan dokumen yang memiliki atribut numerik tertentu. Anda dapat mencari nilai yang tepat atau rentang nilai dalam bidang numerik apa pun (`double`,, `double-array``int`,`int-array`). Untuk mencari rentang, Anda menentukan batas atas dan bawah, dipisahkan oleh koma, dan melampirkan rentang dalam tanda kurung atau tanda kurung. Gunakan tanda kurung siku ([,]) saat Anda ingin menyertakan batas, dan kurawal kurawal (\$1,\$1) untuk mengecualikan batas. Contoh: 
+ `year:2000`cocok dengan dokumen yang bidang tahunnya berisi nilai 2000.
+ `year:[2000,}`cocok dengan dokumen yang bidang tahunnya berisi nilai lebih besar dari atau sama dengan 2000
+ `year:{,2000]`cocok dengan dokumen yang bidang tahunnya berisi nilai kurang dari atau sama dengan 2000
+ `year:[2000,2011]`cocok dengan dokumen yang bidang tahunnya berisi nilai antara 2000 dan 2011, inklusif.
+ `year:{2000,2011}`cocok dengan dokumen yang bidang tahunnya berisi nilai antara 2000 dan 2011, eksklusif.

 Anda juga dapat mencari bidang tanggal untuk tanggal atau rentang tanggal tertentu, tetapi Anda harus melampirkan setiap string tanggal dalam tanda kutip tunggal:`release_date:['2000-01-01T00:00:00Z','2011-01-01T00:00:00Z']`.

Misalnya, kueri terstruktur berikut mencari “bintang” di bidang judul, menemukan semua film yang cocok yang dirilis sebelum tahun 2000, dan mengembalikan skor judul, tahun, dan relevansi untuk masing-masing film: 

**Example**  

```
q=(and title:'star' year:{,2000])&q.parser=structured&return=title,year,_score
```

Respons menunjukkan status permintaan, jumlah dokumen yang cocok, dan bidang yang diminta untuk setiap klik.

```
{
    "status": {
        "rid": "hLPckLsoEQoELQo=",
        "time-ms": 2
    },
    "hits": {
        "found": 15,
        "start": 0,
        "hit": [
            {
                "id": "tt0076759",
                "fields": {
                    "title": "Star Wars",
                    "year": "1977",
                    "_score": "5.7601414"
                }
            },
            .
            .
            .
            {
                "id": "tt0088170",
                "fields": {
                    "title": "Star Trek III: The Search for Spock",
                    "year": "1984",
                    "_score": "4.2371693"
                }
            }
        ]
    }
}
```

Untuk informasi selengkapnya tentang membuat kueri penelusuran, lihat. [Mencari Data Anda dengan Amazon CloudSearch](searching.md)

## Menyortir Hasil Pencarian
<a name="ranking-results"></a>

Secara default, Amazon CloudSearch mengurutkan hasil pencarian sesuai dengan relevansi `_score` yang dihasilkan secara otomatis. Anda dapat mengubah peringkat hasil dengan menggunakan parameter *pengurutan* dalam permintaan pencarian Anda untuk menentukan bidang atau ekspresi yang ingin Anda gunakan untuk peringkat. (Ekspresi adalah ekspresi numerik kustom yang dapat dievaluasi untuk setiap dokumen dalam kumpulan dokumen yang cocok. Untuk informasi tentang mendefinisikan ekspresi Anda sendiri, lihat[Mengkonfigurasi Ekspresi](configuring-expressions.md).)

Jika Anda menentukan bidang teks dengan `sort` parameter, hasilnya diurutkan menurut abjad sesuai dengan bidang itu. Misalnya, untuk mengurutkan hasil dari domain film menurut abjad menurut judul, tambahkan `&sort=title asc` ke string kueri Anda:

**Example**  

```
2013-01-01/search?q=(and genres:'Sci-Fi' year:{,2000])&q.parser=structured&return=title,year&sort=title asc
```

Perhatikan bahwa Anda harus secara eksplisit menentukan arah pengurutan, `asc` (naik) atau `desc` (turun). Saat Anda mengurutkan menurut abjad, Amazon CloudSearch mengurutkan berdasarkan titik kode Unicode. Ini berarti angka datang sebelum huruf dan huruf besar datang sebelum huruf kecil. Angka diurutkan sebagai string; misalnya, 10 akan datang sebelum 2.

Demikian pula, Anda dapat menentukan bidang integer dengan `sort` parameter untuk mengurutkan hasil numerik. 

 Jika Anda menentukan daftar kolom atau ekspresi yang dipisahkan koma, bidang atau ekspresi pertama digunakan sebagai kriteria pengurutan primer, yang kedua digunakan sebagai kriteria pengurutan sekunder, dan seterusnya.

Untuk informasi selengkapnya tentang hasil peringkat, lihat [Menyortir Hasil di Amazon CloudSearch](sorting-results.md)

## Mendapatkan Informasi Facet
<a name="w2aab7c21c12"></a>

Facet adalah bidang indeks yang mewakili kategori yang ingin Anda gunakan untuk menyaring dan memfilter hasil pencarian. Saat mengirimkan permintaan penelusuran ke Amazon CloudSearch, Anda dapat meminta informasi aspek untuk mengetahui berapa banyak klik yang memiliki nilai yang sama dalam satu aspek. Anda dapat menampilkan informasi ini bersama dengan hasil pencarian dan menggunakannya untuk memungkinkan pengguna untuk secara interaktif memperbaiki pencarian mereka. (Ini sering disebut sebagai navigasi segi atau pencarian segi.)

Sebuah faset dapat berupa bidang tanggal, literal, atau numerik yang mengaktifkan faset dalam konfigurasi domain Anda. Untuk setiap aspek, Amazon CloudSearch menghitung jumlah klik yang memiliki nilai yang sama. Anda dapat menentukan bucket untuk menghitung jumlah faset untuk himpunan bagian tertentu dari nilai faset. Hanya ember yang memiliki kecocokan yang termasuk dalam hasil facet.

**Untuk mendapatkan jumlah aspek dengan hasil pencarian Anda**
+ Gunakan `facet.FIELD` opsi untuk menentukan bidang yang ingin Anda hitung aspeknya. Untuk IMDb film sampel, faceting data diaktifkan untuk bidang berikut:`genres`,,`rank`,`rating`, `release_date``running_time_secs`, dan`year`. Opsi facet ditentukan sebagai objek JSON. Jika objek JSON kosong,`facet.FIELD={}`, jumlah faset dihitung untuk semua nilai bidang, faset diurutkan berdasarkan jumlah faset, dan 10 aspek teratas dikembalikan dalam hasil:

  ```
  q=star&return=title&facet.genres={}
  ```

Aspek muncul di bawah hit dalam hasil. 

```
facets": {

    "genres": {
        "buckets": [
            {"value": "Comedy","count": 41},
            .
            .
            .
            {"value": "Sport", "count": 7}
        ]
    }
}
```

Anda dapat menentukan opsi untuk menghitung aspek untuk nilai bidang yang dipilih, menentukan jumlah maksimum nilai faset yang akan disertakan dalam hasil, dan mengontrol bagaimana aspek diurutkan. 

Untuk menentukan bucket untuk menghitung jumlah faset untuk nilai bidang yang dipilih, Anda menentukan opsi. `buckets` Misalnya, permintaan berikut mengurutkan jumlah aspek untuk bidang tahun menurut dekade:

```
q=star&facet.year={buckets:["[1970,1979]","[1980,1989]","[1990,1999]"]}
```

Ini membatasi jumlah faset ke tiga rentang yang ditentukan: 

```
"facets": {
        "year": {
            "buckets": [
                {"value": "[1970,1979]", "count": 3},
                {"value": "[1980,1989]","count": 7},
                {"value": "[1990,1999]","count": 12}
            ]
        }
}
```

Untuk informasi selengkapnya tentang menentukan opsi facet, lihat. [Mendapatkan dan Menggunakan Informasi Facet di Amazon CloudSearch](faceting.md)

## Mendapatkan Sorotan Pencarian
<a name="getting-highlights"></a>

Sorotan pencarian adalah kutipan dari bidang teks atau teks-array yang menunjukkan di mana istilah pencarian terjadi dalam bidang. 

**Untuk mendapatkan informasi sorotan dengan hasil pencarian Anda**
+ Gunakan `highlight.FIELD` opsi untuk menentukan bidang teks atau teks-array yang ingin Anda soroti. Bidang harus disorot diaktifkan dalam opsi pengindeksan domain Anda. Untuk IMDb film contoh penyorotan data diaktifkan untuk bidang berikut:`actors`,, `directors``plot`, dan`title`. Opsi sorotan ditentukan sebagai objek JSON. Jika objek JSON kosong`highlight.FIELD={}`, Amazon CloudSearch menyoroti semua kemunculan istilah pencarian dengan melampirkannya dalam tag penekanan HTML`<em>term</em>`, dan kutipan dikembalikan sebagai HTML.

  ```
  q=title:'star'&q.parser=structured&return=_no_fields&highlight.title={}
  ```

Informasi sorotan disertakan dengan setiap hit pencarian. 

```
hits": {
    "found": 29,
    "start": 0,
    "hit": [
        {
            "id": "tt0796366",
            "highlights": {
                "title": "<em>Star</em> Trek"
            }
        },
        .
        .
        .
        {
            "id": "tt2488496",
            "highlights": {
                "title": "<em>Star</em> Wars: Episode VII"
            }
        }
    ]
}
```

Untuk informasi selengkapnya tentang menentukan opsi sorotan, lihat[Menyoroti Pencarian Hits di Amazon CloudSearch](highlighting.md).