Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Tutorial: Memulai dengan Amazon Tanpa OpenSearch Server
Tutorial ini memandu Anda melalui langkah-langkah dasar untuk mendapatkan koleksi *pencarian* Amazon OpenSearch Tanpa Server dan berjalan dengan cepat. Koleksi pencarian memungkinkan Anda untuk memberi daya pada aplikasi di jaringan internal dan aplikasi yang menghadap ke internet, seperti pencarian situs web e-commerce dan pencarian konten.
Untuk mempelajari cara menggunakan koleksi *pencarian vektor*, lihat[Bekerja dengan koleksi pencarian vektor](serverless-vector-search.md). Untuk informasi lebih rinci tentang penggunaan koleksi, lihat [Mengelola koleksi Amazon OpenSearch Tanpa Server](serverless-manage.md) dan topik lainnya dalam panduan ini.
Anda akan menyelesaikan langkah-langkah berikut dalam tutorial ini:
1. [Konfigurasikan izin](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-permissions)
1. [Buat koleksi](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-create)
1. [Unggah dan cari data](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-index)
1. [Hapus koleksi](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-delete)
**catatan**
Kami menyarankan Anda hanya menggunakan karakter ASCII untuk Anda. `IndexName` Jika Anda tidak menggunakan karakter ASCII untuk Anda`IndexName`, CloudWatch metrik `IndexName` in akan dikonversi ke format URL yang dikodekan untuk karakter non-ASCII.
## Langkah 1: Konfigurasikan izin
Untuk menyelesaikan tutorial ini, dan untuk menggunakan OpenSearch Tanpa Server secara umum, Anda harus memiliki izin IAM yang benar. Dalam tutorial ini, Anda akan membuat koleksi, mengunggah dan mencari data, dan kemudian menghapus koleksi.
Pengguna atau peran Anda harus memiliki [kebijakan berbasis identitas terlampir dengan izin](security-iam-serverless.md#security-iam-serverless-id-based-policies) minimum berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"aoss:CreateCollection",
"aoss:ListCollections",
"aoss:BatchGetCollection",
"aoss:DeleteCollection",
"aoss:CreateAccessPolicy",
"aoss:ListAccessPolicies",
"aoss:UpdateAccessPolicy",
"aoss:CreateSecurityPolicy",
"aoss:GetSecurityPolicy",
"aoss:UpdateSecurityPolicy",
"iam:ListUsers",
"iam:ListRoles"
],
"Effect": "Allow",
"Resource": "*"
}
]
}
```
------
Untuk informasi selengkapnya tentang izin IAM OpenSearch Tanpa Server, lihat. [Identity and Access Management untuk Amazon OpenSearch Serverless](security-iam-serverless.md)
## Langkah 2: Buat koleksi
Koleksi adalah sekelompok OpenSearch indeks yang bekerja sama untuk mendukung beban kerja atau kasus penggunaan tertentu.
**Untuk membuat koleksi OpenSearch Tanpa Server**
1. Buka konsol OpenSearch Layanan Amazon di [https://console.aws.amazon.com/aos/rumah](https://console.aws.amazon.com/aos/home ).
1. Pilih **Koleksi** di panel navigasi kiri dan pilih **Buat koleksi**.
1. Beri nama **film** koleksi.
1. Untuk jenis koleksi, pilih **Cari**. Untuk informasi selengkapnya, lihat [Memilih jenis koleksi](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html#serverless-usecase).
1. Untuk **Keamanan**, pilih **Standard create**.
1. Di bawah **Enkripsi**, pilih **Gunakan Kunci milik AWS**. Ini adalah AWS KMS key yang akan digunakan OpenSearch Tanpa Server untuk mengenkripsi data Anda.
1. Di bawah **Jaringan**, konfigurasikan pengaturan jaringan untuk koleksi.
+ Untuk jenis akses, pilih **Publik**.
+ Untuk jenis sumber daya, pilih **Aktifkan akses ke OpenSearch titik akhir** dan **Aktifkan akses ke OpenSearch Dasbor**. Karena Anda akan mengunggah dan mencari data menggunakan OpenSearch Dasbor, Anda harus mengaktifkan keduanya.
1. Pilih **Berikutnya**.
1. Untuk **Mengonfigurasi akses data**, atur pengaturan akses untuk koleksi. [Kebijakan akses data](serverless-data-access.md) memungkinkan pengguna dan peran untuk mengakses data dalam koleksi. Dalam tutorial ini, kami akan memberikan satu pengguna izin yang diperlukan untuk mengindeks dan mencari data dalam koleksi *film*.
Buat aturan tunggal yang menyediakan akses ke koleksi *film*. Beri nama aturan **Akses koleksi Film**.
1. Pilih **Tambahkan prinsipal, pengguna IAM****, dan peran**, lalu pilih pengguna atau peran yang akan Anda gunakan untuk masuk ke OpenSearch Dasbor dan mengindeks data. Pilih **Simpan**.
1. Di bawah **Izin indeks**, pilih semua izin.
1. Pilih **Berikutnya**.
1. Untuk pengaturan kebijakan akses, pilih **Buat kebijakan akses data baru** dan beri nama **film** kebijakan.
1. Pilih **Berikutnya**.
1. Tinjau pengaturan koleksi Anda dan pilih **Kirim**. Tunggu beberapa menit hingga status koleksi menjadi`Active`.
## Langkah 3: Unggah dan cari data
Anda dapat mengunggah data ke koleksi OpenSearch Tanpa Server menggunakan [Postman atau cURL](https://www.postman.com/downloads/). Untuk singkatnya, contoh-contoh ini menggunakan **Dev Tools dalam konsol** OpenSearch Dashboards.
**Untuk mengindeks dan mencari data dalam koleksi film**
1. Pilih **Koleksi** di panel navigasi kiri dan pilih koleksi **film** untuk membuka halaman detailnya.
1. Pilih URL OpenSearch Dasbor untuk koleksi. URL mengambil format`https://dashboards.{region}.aoss.amazonaws.com/_login/?collectionId={collection-id}`.
1. Dalam OpenSearch Dashboards, buka panel navigasi kiri dan pilih **Dev** Tools.
1. Untuk membuat indeks tunggal yang disebut indeks *film,* kirim permintaan berikut:
```
PUT movies-index
```
![\[OpenSearch Dashboards console showing PUT request for movies-index with JSON response.\]](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/images/serverless-gsg-create.png)
1. Untuk mengindeks satu dokumen ke dalam *indeks film*, kirim permintaan berikut:
```
PUT movies-index/_doc/1
{
"title": "Shawshank Redemption",
"genre": "Drama",
"year": 1994
}
```
1. Untuk mencari data di OpenSearch Dasbor, Anda perlu mengonfigurasi setidaknya satu pola indeks. OpenSearch menggunakan pola-pola ini untuk mengidentifikasi indeks mana yang ingin Anda analisis. Buka panel navigasi kiri, pilih **Stack Management**, pilih **Index Patterns**, dan kemudian pilih **Create index pattern**. Untuk tutorial ini, masukkan *film*.
1. Pilih **Langkah selanjutnya** dan kemudian pilih **Buat pola indeks**. Setelah pola dibuat, Anda dapat melihat berbagai bidang dokumen seperti `title` dan `genre`.
1. Untuk mulai mencari data Anda, buka panel navigasi kiri lagi dan pilih **Discover**, atau gunakan [API pencarian](https://opensearch.org/docs/latest/api-reference/search/) dalam Dev Tools.
## Menangani kesalahan
Saat menjalankan operasi indeks dan pencarian, Anda mungkin mendapatkan respons kesalahan berikut:
+ `HTTP 507`— Menunjukkan bahwa kesalahan server internal terjadi. Kesalahan ini umumnya menunjukkan bahwa unit OpenSearch komputasi (OCUs) Anda kelebihan beban oleh volume atau kompleksitas permintaan Anda. Meskipun OpenSearch tanpa server menskalakan secara otomatis untuk mengelola beban, mungkin ada penundaan dalam menerapkan sumber daya tambahan.
Untuk mengurangi kesalahan ini, terapkan kebijakan coba ulang backoff eksponensial. Pendekatan ini untuk sementara mengurangi tingkat permintaan untuk mengelola beban secara efektif. Untuk detail selengkapnya, lihat [Perilaku Coba](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html) lagi di *Panduan Referensi Alat AWS SDKs dan Alat*.
+ `HTTP 402`— Menunjukkan bahwa Anda mencapai batas kapasitas unit OpenSearch komputasi maksimum (OCU). Optimalkan beban kerja Anda untuk mengurangi penggunaan OCU atau meminta peningkatan kuota.
## Langkah 4: Hapus koleksi
Karena koleksi *film* adalah untuk tujuan pengujian, pastikan untuk menghapusnya ketika Anda selesai bereksperimen.
**Untuk menghapus koleksi OpenSearch Tanpa Server**
1. Kembali ke konsol ** OpenSearch Layanan Amazon**.
1. Pilih **Koleksi** di panel navigasi kiri dan pilih koleksi **film**.
1. Pilih **Hapus** dan konfirmasikan penghapusan.
## Langkah selanjutnya
Sekarang setelah Anda tahu cara membuat koleksi dan indeks data, Anda mungkin ingin mencoba beberapa latihan berikut:
+ Lihat opsi lanjutan lainnya untuk membuat koleksi. Untuk informasi selengkapnya, lihat [Mengelola koleksi Amazon OpenSearch Tanpa Server](serverless-manage.md).
+ Pelajari cara mengonfigurasi kebijakan keamanan untuk mengelola keamanan koleksi dalam skala besar. Untuk informasi selengkapnya, lihat [Ikhtisar keamanan di Amazon Tanpa OpenSearch Server](serverless-security.md).
+ Temukan cara lain untuk mengindeks data ke dalam koleksi. Lihat informasi yang lebih lengkap di [Menyerap data ke dalam koleksi Amazon Tanpa OpenSearch Server](serverless-clients.md).