Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mencari sumber daya FHIR di AWS HealthLake
Gunakan [https://hl7.org/fhir/R4/http.html#search](https://hl7.org/fhir/R4/http.html#search)interaksi FHIR untuk mencari satu set sumber daya FHIR di penyimpanan HealthLake data berdasarkan beberapa kriteria filter. `search`Interaksi dapat dilakukan dengan menggunakan permintaan `GET` atau `POST` permintaan. Untuk pencarian yang melibatkan informasi identitas pribadi (PII) atau informasi kesehatan yang dilindungi (PHI), disarankan untuk menggunakan `POST` permintaan, karena PII dan PHI ditambahkan sebagai bagian dari badan permintaan dan dienkripsi dalam perjalanan.
**catatan**
`search`Interaksi FHIR yang dijelaskan dalam Bab ini dibangun sesuai dengan standar HL7 FHIR R4 untuk pertukaran data perawatan kesehatan. Karena merupakan representasi dari layanan HL7 FHIR, itu tidak ditawarkan melalui AWS CLI dan AWS SDKs. Untuk informasi selengkapnya, lihat [https://hl7.org/fhir/R4/http.html#search](https://hl7.org/fhir/R4/http.html#search)di dokumentasi **FHIR R4 RESTful API**.
HealthLake mendukung subset parameter pencarian FHIR R4. Lihat informasi yang lebih lengkap di [Parameter pencarian FHIR R4 untuk HealthLake](reference-fhir-search-parameters.md).
**Topics**
+ [Mencari dengan GET](searching-fhir-resources-get.md)
+ [Mencari dengan POST](searching-fhir-resources-post.md)
+ [Tingkat Konsistensi Pencarian](searching-fhir-consistency-levels.md)
# Mencari sumber daya FHIR dengan GET
Anda dapat menggunakan `GET` permintaan untuk mencari penyimpanan HealthLake data. Saat menggunakan`GET`, HealthLake mendukung penyediaan parameter pencarian sebagai bagian dari URL, tetapi bukan sebagai bagian dari badan permintaan. Untuk informasi selengkapnya, lihat [Parameter pencarian FHIR R4 untuk HealthLake](reference-fhir-search-parameters.md).
**Penting:**
Untuk pencarian yang melibatkan informasi identitas pribadi (PII) atau informasi kesehatan yang dilindungi (PHI), praktik terbaik keamanan memerlukan penggunaan `POST` permintaan, karena PII dan PHI ditambahkan sebagai bagian dari badan permintaan dan dienkripsi dalam perjalanan. Untuk informasi selengkapnya, lihat [Mencari sumber daya FHIR dengan POST](searching-fhir-resources-post.md).
Prosedur berikut diikuti oleh contoh yang digunakan `GET` untuk mencari penyimpanan HealthLake data.
**Untuk mencari penyimpanan HealthLake data dengan `GET`**
1. Kumpulkan HealthLake `region` dan `datastoreId` nilai. Untuk informasi selengkapnya, lihat [Mendapatkan properti penyimpanan data](managing-data-stores-describe.md).
1. Tentukan jenis sumber daya FHIR untuk mencari dan mengumpulkan `id` nilai terkait. Untuk informasi selengkapnya, lihat [Jenis sumber daya](reference-fhir-resource-types.md).
1. Buat URL untuk permintaan menggunakan nilai yang dikumpulkan untuk HealthLake `region` dan`datastoreId`. Juga termasuk `Resource` jenis FHIR dan [parameter pencarian](reference-fhir-search-parameters.md) yang didukung. Untuk melihat seluruh jalur URL dalam contoh berikut, gulir ke atas tombol **Salin**.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource{?[parameters]{&_format=[mime-type]}}
```
1. Kirim `GET` permintaan dengan [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) atau SMART pada otorisasi FHIR. `curl`Contoh berikut mengembalikan jumlah total sumber `Patient` daya dalam penyimpanan HealthLake data. Untuk melihat seluruh contoh, gulir ke atas tombol **Salin**.
------
#### [ SigV4 ]
Otorisasi SiGv4
```
curl --request GET \
'https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?_total=accurate' \
--aws-sigv4 'aws:amz:region:healthlake' \
--user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
--header "x-amz-security-token:$AWS_SESSION_TOKEN" \
--header 'Accept: application/json'
```
------
#### [ SMART on FHIR ]
SMART pada contoh otorisasi FHIR untuk tipe [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html)data.
```
{
"AuthorizationStrategy": "SMART_ON_FHIR",
"FineGrainedAuthorizationEnabled": true,
"IdpLambdaArn": "arn:aws:lambda:your-region:your-account-id:function:your-lambda-name",
"Metadata": "{\"issuer\":\"https://ehr.example.com\", \"jwks_uri\":\"https://ehr.example.com/.well-known/jwks.json\",\"authorization_endpoint\":\"https://ehr.example.com/auth/authorize\",\"token_endpoint\":\"https://ehr.token.com/auth/token\",\"token_endpoint_auth_methods_supported\":[\"client_secret_basic\",\"foo\"],\"grant_types_supported\":[\"client_credential\",\"foo\"],\"registration_endpoint\":\"https://ehr.example.com/auth/register\",\"scopes_supported\":[\"openId\",\"profile\",\"launch\"],\"response_types_supported\":[\"code\"],\"management_endpoint\":\"https://ehr.example.com/user/manage\",\"introspection_endpoint\":\"https://ehr.example.com/user/introspect\",\"revocation_endpoint\":\"https://ehr.example.com/user/revoke\",\"code_challenge_methods_supported\":[\"S256\"],\"capabilities\":[\"launch-ehr\",\"sso-openid-connect\",\"client-public\",\"permission-v2\"]}"
}
```
Penelepon dapat menetapkan izin di lambda otorisasi. Untuk informasi selengkapnya, lihat [OAuth 2.0 cakupan](reference-smart-on-fhir-oauth-scopes.md).
------
#### [ AWS Console ]
**catatan**
HealthLake Konsol hanya mendukung otorisasi SiGv4. SMART pada otorisasi FHIR didukung melalui AWS CLI dan. AWS SDKs
1. Masuk ke halaman [Jalankan kueri](https://console.aws.amazon.com/healthlake/home#/crud) di HealthLake Konsol.
2. Di bawah bagian **Pengaturan kueri**, buat pilihan berikut.
+ **ID Penyimpanan Data** — pilih ID penyimpanan data untuk menghasilkan string kueri.
+ **Jenis kueri** - pilih`Search with GET`.
+ **Jenis sumber daya** - pilih [jenis sumber daya](reference-fhir-resource-types.md) FHIR untuk dicari.
+ **Parameter pencarian** — Pilih [parameter pencarian](reference-fhir-search-parameters.md) atau kombinasi parameter pencarian untuk memfokuskan kueri Anda pada catatan tertentu.
3. Pilih **Run query** (Jalankan kueri).
------
## Contoh: cari dengan GET
Tab berikut memberikan contoh untuk mencari pada jenis sumber daya FHIR tertentu dengan. `GET` Contoh menunjukkan cara menentukan parameter pencarian dalam permintaan URLs.
**catatan**
HealthLake Konsol hanya mendukung otorisasi SiGv4. SMART pada otorisasi FHIR didukung melalui AWS CLI dan. AWS SDKs
HealthLake mendukung subset parameter pencarian FHIR R4. Untuk informasi selengkapnya, lihat [Parameter pencarian](reference-fhir-search-parameters.md).
------
#### [ Patient (age) ]
Meskipun usia bukan tipe sumber daya yang ditentukan di FHIR, ia ditangkap sebagai elemen dalam tipe [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html)sumber daya. Gunakan contoh berikut untuk membuat permintaan pencarian `GET` berbasis pada jenis [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html)sumber daya menggunakan elemen [BirthDate](https://hl7.org/fhir/R4/patient-definitions.html#Patient.birthDate) dan [pembanding `eq` pencarian](reference-fhir-search-parameters.md#search-comparators) untuk mencari individu yang lahir pada tahun 1997.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?birthdate=eq1997
```
------
#### [ Condition ]
Gunakan contoh berikut untuk membuat `GET` permintaan pada jenis [https://hl7.org/fhir/R4/condition.html](https://hl7.org/fhir/R4/condition.html)sumber daya. Pencarian menemukan kondisi di penyimpanan HealthLake data Anda yang berisi kode medis SNOMED`72892002`, yang diterjemahkan menjadi. `Normal pregnancy`
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Condition?code=72892002
```
------
#### [ DocumentationReference ]
Contoh berikut menunjukkan cara membuat `GET` permintaan pada jenis [https://hl7.org/fhir/R4/documentreference.html](https://hl7.org/fhir/R4/documentreference.html)sumber daya untuk `Patient` (s) dengan diagnosis streptokokus dan yang juga telah diresepkan amoksisilin.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/DocumentReference?_lastUpdated=le2021-12-19&infer-icd10cm-entity-text-concept-score;=streptococcal|0.6&infer-rxnorm-entity-text-concept-score=Amoxicillin|0.8
```
------
#### [ Location ]
Gunakan contoh berikut untuk membuat `GET` permintaan pada jenis [https://hl7.org/fhir/R4/location.html](https://hl7.org/fhir/R4/location.html)sumber daya. Pencarian berikut menemukan lokasi di toko HealthLake data Anda yang berisi nama kota Boston sebagai bagian dari alamat.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Location?address=boston
```
------
#### [ Observation ]
Gunakan contoh berikut untuk membuat permintaan pencarian `GET` berbasis pada jenis [https://hl7.org/fhir/R4/observation.html](https://hl7.org/fhir/R4/observation.html)sumber daya. Pencarian ini menggunakan [parameter `value-concept` pencarian](reference-fhir-search-parameters.md) untuk mencari kode medis`266919005`, yang diterjemahkan menjadi`Never smoker`.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation?value-concept=266919005
```
------
# Mencari sumber daya FHIR dengan POST
Anda dapat menggunakan [https://hl7.org/fhir/R4/search.html](https://hl7.org/fhir/R4/search.html)interaksi FHIR dengan `POST` permintaan untuk mencari penyimpanan HealthLake data. Saat menggunakan`POST`, HealthLake mendukung parameter pencarian baik di URL atau di badan permintaan, tetapi Anda tidak dapat menggunakan keduanya dalam satu permintaan.
**Penting:**
Untuk pencarian yang melibatkan informasi identitas pribadi (PII) atau informasi kesehatan yang dilindungi (PHI), praktik terbaik keamanan memerlukan penggunaan `POST` permintaan, karena PII dan PHI ditambahkan sebagai bagian dari badan permintaan dan dienkripsi dalam perjalanan.
Prosedur berikut diikuti dengan contoh menggunakan `search` interaksi FHIR R4 dengan `POST` untuk mencari penyimpanan HealthLake data. Contoh menunjukkan cara menentukan parameter pencarian di badan permintaan JSON.
**Untuk mencari penyimpanan HealthLake data dengan `POST`**
1. Kumpulkan HealthLake `region` dan `datastoreId` nilai. Untuk informasi selengkapnya, lihat [Mendapatkan properti penyimpanan data](managing-data-stores-describe.md).
1. Tentukan jenis sumber daya FHIR untuk mencari dan mengumpulkan `id` nilai terkait. Untuk informasi selengkapnya, lihat [Jenis sumber daya](reference-fhir-resource-types.md).
1. Buat URL untuk permintaan menggunakan nilai yang dikumpulkan untuk HealthLake `region` dan`datastoreId`. Juga termasuk `Resource` jenis dan `_search` interaksi FHIR. Untuk melihat seluruh jalur URL dalam contoh berikut, gulir ke atas tombol **Salin**.
```
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/_search
```
1. Membangun badan JSON untuk permintaan, menentukan data FHIR untuk mencari. Untuk tujuan prosedur ini, Anda akan mencari `Observation` sumber daya untuk menemukan pasien yang tidak pernah merokok. Untuk menentukan status kode medis`Never smoker`, atur `value-concept=266919005` di badan permintaan JSON. Simpan file sebagai `search-observation.json`.
```
value-concept=266919005
```
1. Kirim permintaan . `search`Interaksi FHIR menggunakan `GET` permintaan dengan [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) atau SMART pada otorisasi FHIR.
**catatan**
Saat membuat `POST` permintaan dengan parameter pencarian di badan permintaan, gunakan `Content-Type: application/x-www-form-urlencoded` sebagai bagian dari header.
`curl`Contoh berikut membuat permintaan pencarian berbasis Pos pada jenis `Observation` sumber daya. Permintaan menggunakan parameter [https://hl7.org/fhir/R4/observation.html#search](https://hl7.org/fhir/R4/observation.html#search)pencarian untuk mencari kode medis `266919005` yang menunjukkan nilai`Never smoker`. Untuk melihat seluruh contoh, gulir ke atas tombol **Salin**.
------
#### [ SigV4 ]
Otorisasi SiGv4
```
curl --request POST \
'https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation/_search' \
--aws-sigv4 'aws:amz:region:healthlake' \
--user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
--header "x-amz-security-token:$AWS_SESSION_TOKEN" \
--header "Content-Type: application/x-www-form-urlencoded"
--header "Accept: application/json"
--data @search-observation.json
```
------
#### [ SMART on FHIR ]
SMART pada contoh otorisasi FHIR untuk tipe [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html)data.
```
{
"AuthorizationStrategy": "SMART_ON_FHIR",
"FineGrainedAuthorizationEnabled": true,
"IdpLambdaArn": "arn:aws:lambda:your-region:your-account-id:function:your-lambda-name",
"Metadata": "{\"issuer\":\"https://ehr.example.com\", \"jwks_uri\":\"https://ehr.example.com/.well-known/jwks.json\",\"authorization_endpoint\":\"https://ehr.example.com/auth/authorize\",\"token_endpoint\":\"https://ehr.token.com/auth/token\",\"token_endpoint_auth_methods_supported\":[\"client_secret_basic\",\"foo\"],\"grant_types_supported\":[\"client_credential\",\"foo\"],\"registration_endpoint\":\"https://ehr.example.com/auth/register\",\"scopes_supported\":[\"openId\",\"profile\",\"launch\"],\"response_types_supported\":[\"code\"],\"management_endpoint\":\"https://ehr.example.com/user/manage\",\"introspection_endpoint\":\"https://ehr.example.com/user/introspect\",\"revocation_endpoint\":\"https://ehr.example.com/user/revoke\",\"code_challenge_methods_supported\":[\"S256\"],\"capabilities\":[\"launch-ehr\",\"sso-openid-connect\",\"client-public\",\"permission-v2\"]}"
}
```
Penelepon dapat menetapkan izin di lambda otorisasi. Untuk informasi selengkapnya, lihat [OAuth 2.0 cakupan](reference-smart-on-fhir-oauth-scopes.md).
------
## Contoh: cari dengan POST
Tab berikut memberikan contoh untuk mencari pada jenis sumber daya FHIR tertentu dengan. `POST` Contoh menunjukkan cara menentukan permintaan di URLs.
**catatan**
HealthLake Konsol hanya mendukung otorisasi SiGv4. SMART pada otorisasi FHIR didukung melalui AWS CLI dan. AWS SDKs
HealthLake mendukung subset parameter pencarian FHIR R4. Untuk informasi selengkapnya, lihat [Parameter pencarian](reference-fhir-search-parameters.md).
------
#### [ Patient (age) ]
Meskipun usia bukan tipe sumber daya yang ditentukan di FHIR, ia ditangkap sebagai elemen dalam tipe [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html)sumber daya. Gunakan contoh berikut untuk membuat permintaan pencarian `POST` berbasis pada jenis `Patient` sumber daya. Contoh pencarian berikut menggunakan [pembanding `eq` pencarian](reference-fhir-search-parameters.md#search-comparators) untuk mencari individu yang lahir pada tahun 1997.
```
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient/_search
```
Untuk menentukan tahun 1997 dalam pencarian, tambahkan elemen berikut ke badan permintaan.
```
birthdate=eq1997
```
------
#### [ Condition ]
Menggunakan berikut ini untuk membuat `POST` permintaan pada jenis `Condition` sumber daya. Pencarian ini menemukan lokasi di penyimpanan HealthLake data Anda yang berisi kode medis`72892002`.
Anda harus menentukan URL permintaan dan badan permintaan. Berikut adalah contoh URL permintaan.
```
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Condition/_search
```
Untuk menentukan kode medis yang ingin Anda cari, Anda menambahkan elemen JSON berikut ke badan permintaan.
```
code=72892002
```
------
#### [ DocumentReference ]
Untuk melihat hasil pemrosesan HealthLake bahasa alami terintegrasi (NLP) saat membuat `POST` permintaan pada jenis `DocumentReference` sumber daya, format permintaan sebagai berikut.
```
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/DocumentReference/_search
```
Untuk menentukan parameter `DocumentReference` pencarian untuk referensi, lihat[Cari jenis parameter](reference-fhir-search-parameters.md#search-parameter-types). String kueri berikut menggunakan beberapa parameter penelusuran untuk mencari di operasi Amazon Comprehend Medical API yang digunakan untuk menghasilkan hasil NLP terintegrasi.
```
_lastUpdated=le2021-12-19&infer-icd10cm-entity-text-concept-score;=streptococcal|0.6&infer-rxnorm-entity-text-concept-score=Amoxicillin|0.8
```
------
#### [ Location ]
Gunakan contoh berikut untuk membuat `POST` permintaan pada jenis `Location` sumber daya. Pencarian menemukan lokasi di toko HealthLake data Anda yang berisi nama kota Boston sebagai bagian dari alamat.
Anda harus menentukan URL permintaan dan badan permintaan. Berikut adalah contoh URL permintaan.
```
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Location/_search
```
Untuk menentukan `Boston` dalam pencarian, tambahkan elemen berikut ke badan permintaan:
```
address=Boston
```
------
#### [ Observation ]
Gunakan contoh berikut untuk membuat permintaan pencarian `POST` berbasis pada jenis `Observation` sumber daya. Pencarian menggunakan parameter `value-concept` pencarian untuk mencari kode medis, `266919005` yang menunjukkan`Never smoker`.
```
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation/_search
```
Untuk menentukan status,`Never smoker`, atur `value-concept=266919005` di badan JSON.
```
value-concept=266919005
```
------
# 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 /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. Pencarian selanjutnya:
```
GET /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).