View a markdown version of this page

Tutorial: Memulai dengan Amazon Tanpa OpenSearch Server - OpenSearch Layanan Amazon
Langkah 1: Konfigurasikan izinLangkah 2: Buat koleksiLangkah 3: Unggah dan cari dataMenangani kesalahanLangkah 4: Hapus koleksiLangkah selanjutnya

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 menunjukkan kepada Anda langkah-langkah dasar untuk mendapatkan koleksi pencarian Amazon OpenSearch Tanpa Server dan berjalan dengan cepat. Dengan koleksi pencarian, Anda dapat mengaktifkan 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, lihatBekerja dengan koleksi pencarian vektor. Untuk informasi lebih rinci tentang penggunaan koleksi, lihat Mengelola koleksi Amazon OpenSearch Tanpa Server dan topik lainnya dalam panduan ini.

Anda menyelesaikan langkah-langkah berikut dalam tutorial ini:

  1. Konfigurasikan izin

  2. Buat koleksi

  3. Unggah dan cari data

  4. Hapus koleksi

    catatan

    Gunakan hanya karakter ASCII untuk Anda. IndexName Jika Anda tidak menggunakan karakter ASCII untuk AndaIndexName, CloudWatch metrik IndexName in dikonversi ke format yang dikodekan URL untuk karakter non-ASCII.

Langkah 1: Konfigurasikan izin

Untuk menyelesaikan tutorial ini dan menggunakan OpenSearch Tanpa Server secara umum, Anda harus memiliki izin IAM yang benar. Dalam tutorial ini, Anda membuat koleksi, mengunggah dan mencari data, dan kemudian menghapus koleksi.

Pengguna atau peran Anda harus memiliki kebijakan berbasis identitas terlampir dengan izin 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

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/home.

  2. Di panel navigasi kiri, pilih Koleksi.

  3. Pilih Buat koleksi.

  4. Untuk Nama, masukkan movies.

  5. Untuk jenis Koleksi, pilih Cari. Untuk informasi selengkapnya, lihat Memilih jenis koleksi.

  6. Untuk metode pembuatan Collection, pilih Express Create.

  7. Tinjau pengaturan default. Ini termasuk grup pengumpulan, pengaturan aplikasi OpenSearch UI, enkripsi dengan akses jaringan publik Kunci milik AWS, dan kebijakan akses data yang dibuat secara otomatis.

  8. Pilih Buat koleksi.

  9. Tunggu status koleksi berubah menjadiActive. Ini mungkin memakan waktu beberapa menit.

Tip

Tutorial ini menggunakan metode NextGen Express Create. Anda juga dapat mengakses Express Create dari tombol Express create di banner info di halaman landing untuk jalur yang lebih cepat. Untuk kontrol lebih lanjut atas enkripsi, jaringan, dan pengaturan akses data, gunakan Standard Create. Untuk menggunakan wizard pembuatan koleksi Klasik, pilih Beralih ke Klasik. Untuk informasi selengkapnya, lihat Membuat koleksi.

Langkah 3: Unggah dan cari data

Anda dapat mengunggah data ke koleksi OpenSearch Tanpa Server menggunakan Postman atau cURL. Untuk mempermudah, 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.

  2. Pilih URL OpenSearch Dasbor untuk koleksi. URL mengambil formathttps://dashboards.{region}.aoss.amazonaws.com/_login/?collectionId={collection-id}.

  3. Dalam OpenSearch Dashboards, buka panel navigasi kiri dan pilih Dev Tools.

  4. Untuk membuat indeks tunggal yang disebut indeks film, kirim permintaan berikut:

    PUT movies-index
    OpenSearch Konsol dasbor yang menampilkan permintaan PUT ke indeks film dengan status respons 200.

  5. Untuk mengindeks satu dokumen ke dalam indeks film, kirim permintaan berikut:

    PUT movies-index/_doc/1
{ 
  "title": "Shawshank Redemption",
  "genre": "Drama",
  "year": 1994
}

  6. 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.

  7. Pilih Langkah selanjutnya dan kemudian pilih Buat pola indeks. Setelah pola dibuat, Anda dapat melihat berbagai bidang dokumen seperti title dan genre.

  8. Untuk mulai mencari data Anda, buka panel navigasi kiri lagi dan pilih Discover, atau gunakan API pencarian 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 (OCU) 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 Coba lagi perilaku di AWS SDK dan Panduan Referensi 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, hapus setelah Anda selesai bereksperimen.

Untuk menghapus koleksi OpenSearch Tanpa Server

  1. Kembali ke konsol OpenSearch Layanan Amazon.

  2. Pilih Koleksi di panel navigasi kiri dan pilih koleksi film.

  3. Pilih Hapus dan konfirmasi penghapusan.

Langkah selanjutnya

Sekarang setelah Anda tahu cara membuat koleksi dan indeks data, Anda mungkin ingin mencoba yang berikut ini: