翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# FHIR 検索整合性レベル
<a name="searching-fhir-consistency-levels"></a>

AWS HealthLake の検索インデックスは、SEARCH オペレーションの `GET`および の結果整合性モデルで動作`POST`します。結果整合性では、リソースの検索インデックスの更新が保留中の場合、インデックスの更新が完了するまで、検索結果はリソースのバージョン N-1 を除外します。

 AWS HealthLake に、更新されたリソースに対する整合性モデルの動作を選択できるようになりました。デベロッパーには、「結果整合性」、上記のデフォルトの動作、または「強度整合性」を含めることができます。強力な整合性により、検索インデックスの更新が保留中のリソースのリソースの N-1 バージョンを検索結果に含めることができます。これは、検索インデックスの更新がまだ完了していない場合でも、結果にすべてのリソースが必要なユースケースシナリオに使用できます。お客様は、 `x-amz-fhir-history-consistency-level`リクエストヘッダーを使用してこの動作を制御できます。

## 整合性レベル
<a name="fhir-search-consistency-levels"></a>

強力な整合性  
検索インデックスの更新が保留中のレコードを含む、一致するすべてのレコードを返す`x-amz-fhir-history-consistency-level: strong`ように を設定します。更新直後にリソースを検索する必要がある場合は、このオプションを使用します。

結果整合性  
検索インデックスの更新が完了したレコードのみを返す`x-amz-fhir-history-consistency-level: eventual`ように を設定します。これは、整合性レベルが指定されていない場合のデフォルトの動作です。

## 使用例
<a name="fhir-search-usage"></a>

1. リソースを更新する場合:

   ```
   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"
   }
   ```

1. 後続の検索:

   ```
   GET <baseURL>/Patient?_id=123
   ```

## ベストプラクティス
<a name="fhir-search-best-practices"></a>
+ 最近更新されたリソースをすぐに検索する必要がある場合は、強力な整合性を使用します。
+ 即時の可視性が重要でない一般的なクエリに結果整合性を使用する
+ 即時の可視性と潜在的なパフォーマンスへの影響のトレードオフを考慮する

**注記**  
整合性レベルの設定は、更新されたリソースが検索結果に表示される速度に影響しますが、リソースの実際のストレージには影響しません。  
オプションの`x-amz-fhir-history-consistency-level`ヘッダーを「強力な」に設定すると、リソースあたりの書き込みキャパシティ消費量が 2 倍になります。  
この機能は、バージョン履歴が有効になっているデータストアにのみ適用されます (2024 年 10 月 25 日以降に作成されたすべてのデータストアはデフォルトで有効になっています）。