Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Migrasi ke Amazon CloudSearch 2013-01-01 API
Amazon CloudSearch 2013-01-01 API menawarkan beberapa fitur baru, termasuk dukungan untuk berbagai bahasa, menyoroti istilah penelusuran dalam hasil, dan mendapatkan saran. Untuk menggunakan fitur-fitur ini, Anda membuat dan mengonfigurasi domain pencarian 2013-01-01 baru, memodifikasi pipeline data Anda untuk mengisi domain baru menggunakan format data 2013-01-01, dan memperbarui pipeline kueri Anda untuk mengirimkan permintaan dalam format permintaan 2013-01-01. Panduan migrasi ini merangkum perubahan API dan menyoroti perubahan yang paling mungkin memengaruhi aplikasi Anda.
## Membuat 2013-01-01 Domain Amazon CloudSearch
Jika Anda membuat CloudSearch domain Amazon sebelum peluncuran API 2013-01-01, Anda dapat memilih versi API mana yang akan digunakan saat membuat domain baru. Untuk membuat domain 2013-01-01 melalui konsol, pilih versi 2013-01-01 di Create Domain Wizard. Untuk membuat domain 2013-01-01 dari baris perintah, unduh dan instal AWS CLI dan jalankan perintah. `aws cloudsearch create-domain`
**catatan**
Untuk membuat dan berinteraksi dengan domain 2013-01-01, Anda harus menggunakan alat AWS CLI. Untuk membuat dan berinteraksi dengan domain 2011-02-01, Anda harus menggunakan alat v1.
**Topics**
## Mengkonfigurasi 2013-01-01 Domain Amazon CloudSearch
Anda dapat mengonfigurasi domain 2013-01-01 melalui konsol, alat baris perintah, atau AWS SDKs. 2013-01-01 domain mendukung beberapa opsi konfigurasi baru:
+ **Skema Analisis** —Anda mengonfigurasi skema analisis untuk menentukan opsi pemrosesan teks khusus bahasa untuk `text` dan bidang. `text-array` Amazon CloudSearch sekarang mendukung 33 bahasa, serta opsi untuk bidang multi-bahasa. Untuk informasi selengkapnya, lihat [Mengkonfigurasi Skema Analisis](configuring-analysis-schemes.md). Untuk daftar lengkap bahasa yang didukung, lihat[Bahasa yang Didukung](supported-languages.md).
+ **Opsi Ketersediaan** — Anda dapat mengaktifkan opsi Multi-AZ untuk memperluas domain ke zona ketersediaan kedua untuk memastikan ketersediaan jika terjadi gangguan layanan. Untuk informasi selengkapnya, lihat [Mengkonfigurasi Opsi Ketersediaan](configuring-availability-options.md).
+ **Opsi Penskalaan** —Anda dapat mengatur jenis instans yang diinginkan dan jumlah replikasi yang diinginkan untuk meningkatkan kapasitas unggahan atau pencarian, mempercepat permintaan pencarian, dan meningkatkan toleransi kesalahan. Untuk informasi selengkapnya, lihat [Mengkonfigurasi Opsi Penskalaan di Amazon CloudSearch](configuring-scaling-options.md).
+ **Penyaran—Anda dapat mengonfigurasi sugester** untuk mengimplementasikan fungsionalitas pelengkapan otomatis. Untuk informasi selengkapnya, lihat [Mengkonfigurasi Suggesters untuk Amazon CloudSearch](getting-suggestions.md#configuring-suggesters).
Akses ke layanan CloudSearch konfigurasi Amazon dikelola melalui IAM dan sekarang memungkinkan Anda untuk mengontrol akses ke tindakan konfigurasi tertentu. Perhatikan bahwa Amazon CloudSearch ARN juga telah berubah. Akses ke dokumen domain dan titik akhir pencarian dikelola melalui layanan CloudSearch konfigurasi Amazon. Untuk informasi selengkapnya, lihat [Mengkonfigurasi Akses untuk Amazon CloudSearch](configuring-access.md).
2013-01-01 domain juga mendukung serangkaian opsi pengindeksan yang diperluas:
+ **Skema Analisis** — Anda mengonfigurasi pemrosesan teks khusus bahasa berdasarkan per bidang dengan menentukan skema analisis untuk masing-masing bidang dan bidang. `text` `text-array` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Skema Analisis](configuring-analysis-schemes.md).
+ **Jenis Bidang** —Amazon CloudSearch sekarang mendukung 11 jenis bidang:
+ tanggal-berisi stempel waktu. Tanggal dan waktu ditentukan dalam UTC (Coordinated Universal Time) menurut RFC3339 IETF: 00:00:00 Z. yyyy-mm-ddT Di UTC, misalnya, 17:00 23 Agustus 1970 adalah: 1970-08-23T 17:00:00 Z.
+ date-array—bidang tanggal yang dapat berisi beberapa nilai.
+ double—berisi nilai floating point 64-bit presisi ganda.
+ double-array — bidang ganda yang dapat berisi beberapa nilai.
+ int—berisi nilai integer bertanda 64-bit.
+ int-array—bidang integer yang dapat berisi beberapa nilai.
+ latlon—berisi lokasi yang disimpan sebagai pasangan nilai lintang dan bujur.
+ literal—berisi pengenal atau data lain yang ingin Anda cocokkan dengan tepat.
+ literal-array—bidang literal yang dapat berisi beberapa nilai.
+ teks-berisi data alfanumerik arbitrer.
+ text-array—bidang teks yang dapat berisi beberapa nilai.
+ **Sorot** —saat Anda mengaktifkan opsi sorotan untuk bidang, Anda dapat mengambil kutipan yang menunjukkan di mana istilah penelusuran muncul dalam bidang tersebut. Untuk informasi selengkapnya, lihat [Menyoroti Pencarian Hits di Amazon CloudSearch](highlighting.md).
+ **Sumber** —Anda dapat menentukan sumber untuk bidang untuk menyalin data dari satu bidang ke bidang lainnya, memungkinkan Anda menggunakan data sumber yang sama dengan cara yang berbeda dengan mengonfigurasi opsi yang berbeda untuk bidang tersebut.
Saat mengonfigurasi domain 2013-01-01 Anda, ada beberapa hal yang perlu diingat:
+ Secara default, saat Anda menambahkan bidang, semua opsi yang valid untuk jenis bidang tersebut diaktifkan. Meskipun ini berguna untuk pengembangan dan pengujian, menonaktifkan opsi yang tidak Anda perlukan dapat mengurangi ukuran indeks Anda dan meningkatkan kinerja.
+ Anda harus menggunakan bidang tipe array terpisah untuk bidang multi-nilai.
+ Hanya bidang nilai tunggal yang dapat diurutkan diaktifkan.
+ Hanya `text` dan `text-array` bidang yang dapat disorot diaktifkan.
+ Semua bidang *kecuali* `text` dan `text-array` bidang dapat diaktifkan facet.
+ Bidang literal sekarang peka huruf besar/kecil.
+ Anda tidak lagi harus menyimpan nilai floating point sebagai bilangan bulat — gunakan bidang. `double`
+ Anda dapat menyimpan lokasi menggunakan jenis `latlon` bidang baru. Untuk informasi selengkapnya, lihat [Pencarian dan Peringkat Hasil berdasarkan Lokasi Geografis di Amazon CloudSearch](searching-locations.md).
+ `int`Bidang adalah integer bertanda 64-bit.
+ Alih-alih mengonfigurasi bidang pencarian default, Anda dapat menentukan bidang mana yang akan dicari dengan `q.options` parameter dalam permintaan pencarian Anda. `q.options`Parameter ini juga memungkinkan Anda untuk menentukan bobot untuk masing-masing bidang.
+ Saat menyortir dan mengonfigurasi ekspresi, Anda mereferensikan skor relevansi default dengan nama. `_score` Karena perubahan dalam algoritma relevansi, skor yang dihitung akan berbeda dari yang berada di bawah API 2011-02-01. Untuk informasi selengkapnya, lihat [Mengkonfigurasi Ekspresi](configuring-expressions.md).
+ Ekspresi sekarang mendukung`logn`,`atan2`, dan `haversin` fungsi serta variabel `_score` (skor relevansi teks) dan `_time` (waktu zaman). Jika Anda menyimpan lokasi di `latlon` bidang, Anda dapat mereferensikan nilai lintang dan bujur sebagai `FIELD.latitude` dan. `FIELD.longitude` Anda juga dapat mereferensikan keduanya `int` dan `double` bidang dalam ekspresi. Fungsi-fungsi berikut tidak lagi didukung:`cs.text_relevance`,`erf`,`lgamma`,`rand`, dan`time`. Untuk informasi selengkapnya, lihat [Mengkonfigurasi Ekspresi](configuring-expressions.md).
Untuk informasi selengkapnya tentang mengonfigurasi opsi pengindeksan untuk domain 2013-01-01, lihat. [Mengkonfigurasi Bidang Indeks](configuring-index-fields.md) Untuk informasi selengkapnya tentang mengonfigurasi opsi ketersediaan, opsi penskalaan, opsi pemrosesan teks, pemberi saran, dan ekspresi, lihat. [Membuat dan Mengelola Domain Pencarian](creating-managing-domains.md)
### Tindakan dan Opsi Layanan CloudSearch Konfigurasi Amazon Baru
Tindakan berikut telah ditambahkan ke API Layanan Konfigurasi 2013-01-01:
+ DefineAnalysisScheme
+ DefineExpression
+ DefineSuggester
+ DeleteAnalysisScheme
+ DeleteExpression
+ DeleteSuggester
+ DexcribeAnalysisSchemes
+ DescribeAvailabilityOptions
+ DescribeExpressions
+ DescribeScalingParameters
+ DescribeSuggesters
+ ListDomainNames
+ UpdateAvailabilityOptions
+ UpdateScalingParameters
`deployed`Opsi telah ditambahkan ke tindakan deskripsi untuk bidang indeks, kebijakan akses, dan pemberi saran. Setel `deployed` opsi ke true untuk menampilkan konfigurasi aktif dan mengecualikan perubahan yang tertunda.
### Tindakan dan Opsi Layanan CloudSearch Konfigurasi Amazon yang Usang
Tindakan berikut tidak didukung di API Layanan Konfigurasi 2013-01-01:
+ DefineRankExpression
+ DescribeRankExpression
+ DeleteRankExpression
+ DescribeDefaultSearchField
+ DescribeStemmingOptions
+ DescribeStopwordOptions
+ DescribeSynonymOptions
+ UpdateDefaultSearchField
+ UpdateStemmingOptions
+ UpdateStopwordOptions
+ UpdateSynonymOptions
## Mengunggah Data ke 2013-01-01 Domain Amazon CloudSearch
Dengan API 2013-01-01, Anda tidak perlu lagi menentukan versi dokumen—pembaruan diterapkan sesuai urutan penerimaannya. Anda juga tidak lagi menentukan `lang` atribut untuk setiap dokumen—Anda mengontrol pemrosesan teks khusus bahasa dengan mengonfigurasi skema analisis untuk masing-masing dan bidang. `text` `text-array`
Untuk mengunggah data Anda ke domain 2013-01-01, Anda perlu:
+ Hilangkan `lang` atribut `version` dan dari kumpulan dokumen Anda.
+ Pastikan semua bidang dokumen sesuai dengan bidang indeks yang dikonfigurasi untuk domain Anda. Bidang yang tidak dikenal tidak lagi diabaikan, mereka akan menghasilkan kesalahan.
+ Posting batch dokumen ke titik akhir dokumen domain 2013-01-01 Anda. Perhatikan bahwa Anda harus menentukan versi API 2013-01-01. Misalnya, permintaan berikut memposting batch yang terkandung di `data1.json` `doc-movies-123456789012.us-east-1.cloudsearch.amazonaws.com` titik akhir.
```
curl -X POST --upload-file data1.json doc-movies-123456789012.us-east-1.
cloudsearch.amazonaws.com/2013-01-01/documents/batch --header "Content-Type:
application/json"
```
API 2013-01-01 mendukung prescaling domain Anda untuk meningkatkan kapasitas upload. Jika Anda memiliki sejumlah besar data untuk diunggah, konfigurasikan opsi penskalaan domain Anda dan pilih jenis instans yang lebih besar yang diinginkan. Pindah ke jenis instans yang lebih besar memungkinkan Anda mengunggah batch secara paralel dan mengurangi waktu yang diperlukan untuk data yang akan diindeks. Untuk informasi selengkapnya, lihat [Mengkonfigurasi Opsi Penskalaan di Amazon CloudSearch](configuring-scaling-options.md).
Untuk informasi selengkapnya tentang memformat data Anda, lihat[Mempersiapkan Data Anda](preparing-data.md).
## Mencari 2013-01-01 Domain Amazon CloudSearch
Sebagian besar upaya yang diperlukan untuk memigrasikan domain CloudSearch penelusuran Amazon yang ada ke API 2013-01-01 memperbarui pipeline kueri Anda untuk mengirimkan permintaan penelusuran yang kompatibel dengan 2013-01-01.
+ Gunakan versi API 2013-01-01 di semua permintaan.
+ Gunakan `q` parameter untuk menentukan kriteria pencarian untuk semua permintaan. `bq`Parameter tidak lagi didukung. Untuk menggunakan sintaks pencarian terstruktur (Boolean), tentukan `q.parser=structured` dalam permintaan.
+ Parameter tidak dapat diulang dalam permintaan pencarian.
+ Karakter wildcard (\*) hanya didukung saat menggunakan parser kueri sederhana. Gunakan `prefix` operator untuk melakukan pencocokan awalan dengan parser kueri terstruktur. Misalnya, `q=(prefix 'oce')&q.parser=structured`.
+ Gunakan nama bidang `_id` untuk mereferensikan bidang ID dokumen dalam permintaan pencarian. Nama `docid` bidang tidak lagi didukung.
+ Gunakan `range` operator mencari bidang untuk nilai dalam rentang yang ditentukan. `filter`Operator tidak lagi didukung.
+ Gunakan sintaks rentang baru untuk mencari rentang nilai, termasuk tanggal dan lokasi yang disimpan di `latlon` bidang. Notasi double dot (..) tidak lagi didukung. Pisahkan batas atas dan bawah dengan koma (,), dan lampirkan rentang dalam tanda kurung atau kawat gigi. Braket persegi ([,]) menunjukkan bahwa ikatan disertakan, penjepit keriting ({,}) tidak termasuk batas. Misalnya, `year:2008..2011` sekarang dinyatakan sebagai`year:[2008,2011]`. Rentang terbuka seperti `year:..2011` sekarang dinyatakan sebagai`year:{,2011]`.
+ Gunakan `term` operator untuk mencari bidang untuk nilai tertentu. `field`Operator tidak lagi didukung.
+ Gunakan `q.options` parameter untuk menentukan bobot bidang. `cs.text_relevance`Fungsi ini tidak lagi didukung. Misalnya, `q.options={fields:['title^2','plot^0.5']}`.
+ Gunakan `fq` parameter untuk memfilter hasil tanpa mempengaruhi bagaimana dokumen yang cocok dinilai dan diurutkan.
+ Gunakan titik (.) sebagai pemisah daripada tanda hubung (-) dalam parameter awalan:,,. `expr.NAME` `facet.FIELD` `highlight.FIELD`
+ Gunakan `facet.FIELD` parameter untuk menentukan semua opsi facet. `facet-FIELD-constraints`Parameter `facet-FIELD-top-N``facet-FIELD-sort`,, dan tidak lagi didukung.
+ Gunakan `sort` parameter untuk menentukan bidang atau ekspresi yang ingin Anda gunakan untuk menyortir. Anda harus secara eksplisit menentukan arah pengurutan dalam parameter pengurutan. Misalnya, `sort=rank asc, date desc`. `rank`Parameter tidak lagi didukung.
+ Gunakan `expr.NAME` untuk menentukan ekspresi dalam permintaan pencarian. `rank-RANKNAME`Parameter tidak lagi didukung.
+ Gunakan `format=xml` untuk mendapatkan hasil sebagai XHTML. `result-type`Parameter tidak lagi didukung.
API pencarian 2013-01-01 juga mendukung beberapa fitur baru:
+ Penguatan istilah — gunakan `boost` opsi dalam kueri terstruktur untuk meningkatkan pentingnya satu bagian kueri relatif terhadap bagian lainnya. Untuk informasi selengkapnya, lihat [Membangun Kueri Senyawa](searching-compound-queries.md).
+ Pencarian frase ceroboh—gunakan `near` operator dalam kueri terstruktur untuk mencari `text` atau `text-array` bidang untuk beberapa istilah dan temukan dokumen yang berisi istilah dalam jarak yang ditentukan satu sama lain. Anda juga dapat melakukan pencarian frase ceroboh dengan parser kueri sederhana dengan menambahkan `~` operator dan nilai ke frasa. Untuk informasi selengkapnya, lihat [Mencari Frase](searching-text.md#searching-text-phrases).
+ Pencarian fuzzy—gunakan `~` operator untuk melakukan pencarian fuzzy dengan parser kueri sederhana. Tambahkan `~` operator dan nilai ke istilah untuk menunjukkan berapa banyak istilah yang dapat berbeda dan masih dianggap cocok. Untuk informasi selengkapnya, lihat [Mencari Persyaratan Individu](searching-text.md#searching-text-terms).
+ Menyorot—Gunakan `highlight.FIELD` parameter untuk menyorot kecocokan di bidang tertentu. Untuk informasi selengkapnya, lihat [Menyoroti Pencarian Hits di Amazon CloudSearch](highlighting.md).
+ Pelengkapan otomatis—Konfigurasikan sugester dan kirimkan permintaan ke `suggester` sumber daya untuk mendapatkan daftar penyelesaian kueri dan dokumen tempat mereka ditemukan. Untuk informasi selengkapnya, lihat [Mendapatkan Saran Pelengkapan Otomatis di Amazon CloudSearch](getting-suggestions.md).
+ Hasil pencarian parsial—gunakan `partial=true` parameter untuk mengambil sebagian hasil ketika satu atau beberapa partisi indeks tidak tersedia. Secara default Amazon CloudSearch hanya mengembalikan hasil jika setiap partisi dapat ditanyakan.
+ Deep paging—gunakan `cursor` parameter untuk membuat paginasi hasil ketika Anda memiliki kumpulan hasil yang besar. Untuk informasi selengkapnya, lihat [Hasil Paginating](paginating-results.md).
+ Cocokkan semua dokumen—gunakan operator kueri `matchall` terstruktur untuk mengambil semua dokumen dalam indeks.
+ Parser kueri baru—gunakan `q.parser` parameter untuk memilih Lucene atau DisMax parser alih-alih parser sederhana atau terstruktur, atau. `q.parser=lucene` `q.parser=dismax`
Anda juga akan melihat beberapa perubahan perilaku saat mencari:
+ String tidak lagi diberi token pada batas kasus dan periode yang tidak diikuti oleh spasi dianggap sebagai bagian dari istilah. Untuk informasi selengkapnya, lihat [Pemrosesan Teks di Amazon CloudSearch](text-processing.md).
+ Bidang literal sekarang peka huruf besar/kecil.
+ Respons pencarian tidak lagi mencakup peringkat, ekspresi kecocokan, atau waktu CPU. Satu-satunya informasi status yang dikembalikan adalah ID sumber daya (rid) dan waktu pemrosesan (waktu-ms).
+ Ketika Anda mendapatkan informasi facet untuk `int` bidang, `min` dan `max` nilai tidak lagi dikembalikan.
Untuk informasi selengkapnya tentang mencari data Anda, lihat [Mencari Data Anda dengan Amazon CloudSearch](searching.md) dan[Cari Referensi API](search-api.md).
### Parameter dan Opsi Baru di Amazon CloudSearch 2013-01-01 Search API
Parameter berikut telah ditambahkan ke API Pencarian 2013-01-01:
+ `cursor.FIELD`
+ `expr.NAME`
+ `facet.FIELD`
+ `format`
+ `fq`
+ `highlight.FIELD`
+ `partial`
+ `pretty`
+ `q.options`
+ `q.parser`
+ `return`
+ `sort`
`~`Operator telah ditambahkan ke bahasa kueri sederhana untuk mendukung pencarian fuzzy dan pencarian frase yang ceroboh.
Operator berikut telah ditambahkan ke bahasa kueri terstruktur:
+ `boost`
+ `matchall`
+ `near`
+ `phrase`
+ `prefix`
+ `range`
+ `term`
### Parameter dan Opsi CloudSearch Pencarian Amazon yang Usang
Parameter berikut tidak lagi didukung di API pencarian 2013-01-01:
+ bq
+ Segi-bidang-TOP-N
+ Facet-field-sort
+ Kendala aspek-bidang
+ peringkat
+ Rank-rankName
+ bidang kembali
+ tipe hasil
+ Bidang T
Operator dan pintasan berikut tidak lagi didukung dalam kueri terstruktur:
+ bidang
+ filter
+ -
+ \|
+ \+
+ \*
## Batas Diperbarui di Amazon CloudSearch 2013-01-01
Tabel ini merangkum perubahan dan penambahan batas Amazon CloudSearch . Untuk daftar lengkap CloudSearch batas Amazon, lihat[Batas](limits.md).
| Ubah | Ringkasan |
| --- | --- |
| Nama yang dipesan | Skor adalah satu-satunya nama yang dicadangkan. |
| Tidak ada batasan data pengembalian | Data yang dikembalikan dari bidang teks tidak lagi terpotong pada 2 KB. Namun, perlu diingat bahwa ukuran dokumen maksimum adalah 1 MB. |
| Tidak ada batasan pada stemming, stopword, atau kamus sinonim. | Kamus stemming, stopword, dan sinonim dikonfigurasi dalam skema analisis dan tidak ada batasan ukuran definisi skema analisis. |
| Jumlah maksimum nilai bidang | Bidang tipe array dapat berisi hingga 1000 nilai. |
| Ukuran bidang | Ukuran maksimum literal bidang adalah 4096 poin kode Unicode. |
| Rentang bidang int | intBidang dapat berisi nilai dalam kisaran -9.223.372.036,854.775.808 - 9.223.372.036.854.775.807 (inklusif). |
| Jumlah maksimum sorotan | Jumlah maksimum kemunculan istilah pencarian yang dapat disorot adalah 5. |
| Jumlah maksimum sugester | Jumlah maksimum sugester yang dapat Anda konfigurasikan untuk domain adalah 10. |
| Jumlah maksimum hit yang dapat Anda ambil sekaligus | Jumlah maksimum hit yang dapat Anda ambil sekaligus adalah 10.000. sizeParameter dapat berisi nilai dalam kisaran 0 - 10000. |