Langkah 3: Cari CloudSearch Domain Amazon Anda

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

Mencari dengan Search Tester

Penguji penelusuran di CloudSearch konsol Amazon memungkinkan Anda mengirimkan contoh permintaan penelusuran 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, lihatMenyoroti Pencarian Hits di Amazon CloudSearch. Anda juga dapat memilih pemberi saran untuk mendapatkan saran saat Anda memasukkan istilah di bidang Pencarian. (Anda harus mengonfigurasi sugester sebelum Anda bisa mendapatkan saran. Untuk informasi lebih lanjut lihatMendapatkan Saran Pelengkapan Otomatis di Amazon CloudSearch.)

Secara default, hasil diurutkan menurut skor relevansi yang dihasilkan secara otomatis, _score. Untuk informasi tentang menyesuaikan bagaimana hasil diberi peringkat, lihatMenyortir Hasil di Amazon CloudSearch.

Untuk mencari domain Anda

1. Pergi ke CloudSearch konsol Amazon di https://console.aws.amazon.com/cloudsearch/rumah.

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

3. Pilih Jalankan pencarian pengujian.

4. 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 Penelusuran 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. 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.

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

Mengirimkan Permintaan Pencarian dari Browser Web

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 API versi dan harus ditentukan.)

/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 permintaan URL dari bidang Permintaan Pencarian. Endpoint pencarian dan layanan dokumen domain tetap sama selama masa pakai domain.

Secara default, Amazon CloudSearch mengembalikan responsJSON. Anda juga bisa mendapatkan hasil pencarian diformat XML dengan menentukan format parameter,. format=xml (Perhatikan bahwa kesalahan dapat dikembalikan di salah satu JSON atauXML, tergantung dari mana kesalahan itu berasal.)

Mencari Bidang Numerik

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-arrayint,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 ({,}) untuk mengecualikan batas. Sebagai contoh:

• year:2000cocok 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:

contoh

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

Menyortir Hasil Pencarian

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, lihatMengkonfigurasi Ekspresi.)

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:

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 secara 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

Mendapatkan Informasi Facet

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 menyempurnakan 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_daterunning_time_secs, danyear. Opsi facet ditentukan sebagai JSON objek. Jika JSON objek 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

Mendapatkan Sorotan Pencarian

Sorotan pencarian adalah kutipan dari bidang teks atau teks-array yang menunjukkan di mana istilah pencarian terjadi di 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,, directorsplot, dantitle. Opsi sorotan ditentukan sebagai JSON objek. Jika JSON objek kosonghighlight.FIELD={}, Amazon CloudSearch menyoroti semua kemunculan istilah pencarian dengan melampirkannya dalam tag HTML penekanan<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, lihatMenyoroti Pencarian Hits di Amazon CloudSearch.