Titik waktu di Amazon OpenSearch Service - OpenSearch Layanan Amazon

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

Titik waktu di Amazon OpenSearch Service

Fitur point in time (PIT) adalah jenis pencarian yang memungkinkan Anda menjalankan kueri berbeda terhadap kumpulan data yang diperbaiki tepat waktu. Biasanya, ketika Anda menjalankan kueri yang sama pada indeks yang sama pada titik waktu yang berbeda, Anda menerima hasil yang berbeda karena dokumen terus diindeks, diperbarui, dan dihapus. Dengan PIT, Anda dapat query terhadap keadaan konstan dataset Anda.

Penggunaan utama fitur PIT adalah memasangkannya dengansearch_after fungsionalitas. Ini adalah metode pagination yang disukai OpenSearch, terutama untuk pagination dalam, karena beroperasi pada dataset yang dibekukan dalam waktu, itu tidak terikat pada query, dan mendukung pagination konsisten maju dan mundur. Anda dapat menggunakan PIT dengan OpenSearch Service versi 2.5 dan yang lebih baru.

Untuk informasi lebih lanjut tentang PIT, lihat Point in Time dalam OpenSearch dokumentasi.

Pertimbangan-pertimbangan

Pertimbangkan sebagai berikut ketika Anda mengkonfigurasi pencarian PIT Anda:

  • Jika Anda meningkatkan dari domain 2.3 dan memerlukan kontrol akses butiran halus pada tindakan PIT, Anda perlu menambahkan tindakan dan peran tersebut secara manual.

  • Tidak ada ketahanan untuk PIT. Node reboot, penghentian node, penyebaran biru/hijau, dan proses ES restart menyebabkan semua data PIT hilang.

  • Jika pecahan pindah selama penyebaran biru/hijau, hanya segmen data langsung yang ditransfer ke node baru. Segmen pecahan yang dipegang oleh PIT (baik secara eksklusif maupun yang dibagikan dengan data hidup) tetap berada di simpul lama.

  • Pencarian PIT saat ini tidak berfungsi dengan pencarian asinkron.

Buat PIT

Untuk membuat PIT, kirim permintaan HTTP untuk_search/point_in_time menggunakan format berikut:

POST opensearch-domain/my-index/_search/point_in_time?keep_alive=time

Anda dapat menentukan opsi PIT berikut:

Opsi Deskripsi Nilai default Diperlukan
keep_alive

Jumlah waktu untuk menjaga PIT. Setiap kali Anda mengakses PIT dengan permintaan pencarian, masa pakai PIT diperpanjang dengan jumlah waktu yang sama dengankeep_alive parameter. Parameter kueri ini diperlukan saat Anda membuat PIT, tetapi opsional dalam permintaan pencarian.

Ya
preference

Sebuah string yang menentukan node atau pecahan yang digunakan untuk melakukan pencarian.

Acak Tidak
routing String yang menentukan untuk merutekan permintaan pencarian ke pecahan tertentu. Dokumennya_id Tidak
expand_wildcards String yang menentukan jenis indeks yang dapat mencocokkan pola wildcard. Mendukung nilai yang dipisahkan koma. Nilai yang benar adalah sebagai berikut:
  • all: Cocokkan indeks atau aliran data apa pun, termasuk yang tersembunyi.

  • open: Cocokkan indeks terbuka, tidak tersembunyi, atau aliran data yang tidak tersembunyi.

  • closed: Cocokkan indeks tertutup, tidak tersembunyi, atau aliran data yang tidak tersembunyi.

  • hidden: Cocokkan indeks tersembunyi atau aliran data. Harus dikombinasikan dengan terbuka, tertutup atau terbuka dan tertutup.

  • none: Tidak ada pola wildcard yang diterima.

open Tidak
allow_partial_pit_creation Sebuah boolean yang menentukan apakah akan membuat PIT dengan kegagalan sebagian. true Tidak

Respon sampel

{ "pit_id": "o463QQEPbXktaW5kZXgtMDAwMDAxFnNOWU43ckt3U3IyaFVpbGE1UWEtMncAFjFyeXBsRGJmVFM2RTB6eVg1aVVqQncAAAAAAAAAAAIWcDVrM3ZIX0pRNS1XejE5YXRPRFhzUQEWc05ZTjdyS3dTcjJoVWlsYTVRYS0ydwAA", "_shards": { "total": 1, "successful": 1, "skipped": 0, "failed": 0 }, "creation_time": 1658146050064 }

Ketika Anda membuat PIT, Anda menerima ID PIT di respon. Ini adalah ID yang Anda gunakan untuk melakukan pencarian dengan PIT.

Izin titik waktu

PIT mendukung kontrol akses detail. Jika Anda meningkatkan ke domain 2,5 dan memerlukan kontrol akses butiran halus, Anda perlu membuat peran secara manual dengan izin berikut:

# Allows users to use all point in time search search functionality point_in_time_full_access: reserved: true index_permissions: - index_patterns: - '*' allowed_actions: - "indices:data/read/point_in_time/create" - "indices:data/read/point_in_time/delete" - "indices:data/read/point_in_time/readall" - "indices:data/read/search" - "indices:monitor/point_in_time/segments" # Allows users to use point in time search search functionality for specific index # All type operations like list all PITs, delete all PITs are not supported in this case point_in_time_index_access: reserved: true index_permissions: - index_patterns: - 'my-index-1' allowed_actions: - "indices:data/read/point_in_time/create" - "indices:data/read/point_in_time/delete" - "indices:data/read/search" - "indices:monitor/point_in_time/segments"

Untuk domain dengan versi 2.5 ke atas, Anda dapat menggunakanpoint_in_time_full_access peran bawaan. Untuk informasi selengkapnya, lihat Model keamanan di OpenSearch dokumentasi.

Pengaturan PIT

OpenSearch memungkinkan Anda mengubah semua pengaturan PIT yang tersedia menggunakan_cluster/settings API. Di OpenSearch Layanan, saat ini Anda tidak dapat mengubah pengaturan.

Pencarian lintas klaster

Anda dapat membuat PITs, mencari dengan PIT ID, daftar PITs, dan menghapus PITs di seluruh cluster dengan batasan kecil berikut:

  • Anda dapat mencantumkan semua dan menghapus semua lubang hanya pada domain sumber.

  • Anda tidak dapat meminimalkan perjalanan putaran jaringan sebagai bagian dari kueri pencarian lintas-klaster.

Untuk informasi selengkapnya, lihat Pencarian lintas-cluster di Layanan Amazon OpenSearch .

UltraWarm

Pencarian PIT dengan UltraWarm indeks terus bekerja. Untuk informasi selengkapnya, lihat UltraWarm penyimpanan untuk Amazon OpenSearch Service.

catatan

Anda dapat memantau statistik pencarian PIT di CloudWatch. Untuk daftar lengkap metrik, lihat Metrik titik dalam waktu.