Tingkat Konsistensi Pencarian FHIR - AWS HealthLake
Tingkat konsistensiContoh penggunaanPraktik terbaik

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

Tingkat Konsistensi Pencarian FHIR

HealthLakeIndeks pencarian AWS beroperasi pada model Konsistensi Akhir untuk GET dan POST dengan operasi SEARCH. Dengan konsistensi akhirnya, jika ada pembaruan indeks penelusuran yang tertunda untuk sumber daya, hasil pencarian mengecualikan versi N-1 sumber daya hingga pembaruan indeks selesai.

AWS HealthLake sekarang menyertakan kemampuan untuk memilih bagaimana model konsistensi akan berperilaku untuk sumber daya yang diperbarui. Pengembang dapat menyertakan 'Konsistensi Akhir', perilaku default yang dijelaskan di atas atau 'Konsistensi Kuat'. Konsistensi Kuat akan memungkinkan versi N-1 sumber daya untuk sumber daya dengan pembaruan indeks pencarian yang tertunda untuk disertakan dalam hasil pencarian. Ini dapat digunakan untuk skenario kasus penggunaan di mana semua sumber daya diperlukan dalam hasil bahkan ketika pembaruan indeks pencarian belum selesai. Pelanggan dapat mengontrol perilaku ini menggunakan header x-amz-fhir-history-consistency-level permintaan.

Tingkat konsistensi

Konsistensi kuat

Setel x-amz-fhir-history-consistency-level: strong untuk mengembalikan semua catatan yang cocok, termasuk yang memiliki pembaruan indeks penelusuran yang tertunda. Gunakan opsi ini ketika Anda perlu mencari sumber daya segera setelah pembaruan.

Konsistensi akhirnya

Setel x-amz-fhir-history-consistency-level: eventual untuk mengembalikan hanya catatan yang telah menyelesaikan pembaruan indeks pencarian. Ini adalah perilaku default jika tidak ada tingkat konsistensi yang ditentukan.

Contoh penggunaan

  1. Saat memperbarui sumber daya:

    POST <baseURL>/Patient
Content-Type: application/fhir+json
x-amz-fhir-history-consistency-level: strong

{
  "resourceType": "Patient",
  "id": "123",
  "meta": {
    "profile": ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient"]
  },
  "identifier": [
    {
      "system": "http://example.org/identifiers",
      "value": "123"
    }
  ],
  "active": true,
  "name": [
    {
      "family": "Smith",
      "given": ["John"]
    }
  ],
  "gender": "male",
  "birthDate": "1970-01-01"
}

  2. Pencarian selanjutnya:

    GET <baseURL>/Patient?_id=123

Praktik terbaik

  • Gunakan konsistensi yang kuat ketika Anda perlu segera mencari sumber daya yang baru diperbarui

  • Gunakan konsistensi akhirnya untuk kueri umum di mana visibilitas langsung tidak penting

  • Pertimbangkan trade-off antara visibilitas langsung dan potensi dampak kinerja

catatan

Pengaturan tingkat konsistensi memengaruhi seberapa cepat sumber daya yang diperbarui muncul di hasil penelusuran tetapi tidak memengaruhi penyimpanan sumber daya yang sebenarnya.

Menyetel x-amz-fhir-history-consistency-level header opsional ke 'kuat' menggandakan konsumsi kapasitas tulis per sumber daya.

Fitur ini hanya berlaku untuk penyimpanan data yang mengaktifkan riwayat versi (semua datastores yang dibuat setelah 25 Oktober 2024 mengaktifkannya secara default).