Cara mengekspor data FHIR
Fitur Ekspor Massal memungkinkan data untuk diekspor dari Server FHIR sesuai spesifikasi FHIR.
Sebelum menggunakan $export, Anda harus memastikan bahwa layanan FHIR dikonfigurasi untuk menggunakannya. Untuk mengonfigurasi pengaturan ekspor dan membuat akun penyimpanan Azure, lihat halaman konfigurasikan data ekspor.
Menggunakan perintah $export
Setelah mengonfigurasi layanan FHIR untuk ekspor, Anda dapat menggunakan perintah $export guna mengekspor data keluar dari layanan. Data akan disimpan ke akun penyimpanan yang Anda tentukan saat mengonfigurasi ekspor. Untuk mempelajari cara memanggil perintah $export di server FHIR, baca dokumentasi tentang spesifikasi $export HL7 FHIR.
Pekerjaan terjebak dalam keadaan buruk
Dalam beberapa situasi, ada potensi pekerjaan terjebak dalam keadaan buruk. Ini dapat terjadi terutama jika izin akun penyimpanan belum disiapkan dengan benar. Salah satu cara untuk memvalidasi apakah ekspor Anda berhasil adalah dengan memeriksa akun penyimpanan Anda untuk melihat apakah file kontainer yang sesuai (yaitu, ndjson) ada. Jika tidak ada, dan tidak ada pekerjaan ekspor lain yang berjalan, maka ada kemungkinan pekerjaan saat ini terjebak dalam keadaan buruk. Anda harus membatalkan pekerjaan ekspor dengan mengirim permintaan pembatalan dan mencoba mengantre ulang pekerjaan lagi. Durasi default kami untuk ekspor dalam keadaan buruk adalah 10 menit sebelum akan berhenti dan pindah ke pekerjaan baru atau mencoba kembali ekspor.
Layanan FHIR mendukung $export pada tingkat berikut:
- Sistem:
GET https://<<FHIR service base URL>>/$export>> - Pasien:
GET https://<<FHIR service base URL>>/Patient/$export>> - Grup pasien* - Layanan FHIR mengekspor semua sumber daya terkait tetapi tidak mengekspor karakteristik grup:
GET https://<<FHIR service base URL>>/Group/[ID]/$export>>
Saat data diekspor, file terpisah dibuat untuk setiap jenis sumber daya. Untuk memastikan bahwa file yang diekspor tidak menjadi terlalu besar. Kami membuat file baru setelah ukuran satu file yang diekspor menjadi lebih besar dari 64 MB. Hasilnya adalah Anda mungkin mendapatkan beberapa file untuk setiap jenis sumber daya, yang akan dijumlahkan (yaitu, Pasien-1.ndjson, Pasien-2.ndjson).
Catatan
Patient/$export dan Group/[ID]/$export dapat mengekspor sumber daya duplikat jika sumber daya berada dalam kompartemen lebih dari satu sumber daya, atau berada dalam beberapa grup.
Selain itu, memeriksa status ekspor melalui URL yang dikembalikan oleh header lokasi selama antrean didukung bersama dengan membatalkan pekerjaan ekspor aktual.
Mengekspor data FHIR ke ADLS Gen2
Saat ini kami mendukung $export untuk akun penyimpanan yang diaktifkan ADLS Gen2, dengan batasan berikut:
- Pengguna tidak dapat memanfaatkan namespace hierarkis, namun tidak ada cara untuk menargetkan ekspor ke subdirektori tertentu dalam kontainer. Kami hanya menyediakan kemampuan untuk menargetkan kontainer tertentu (tempat kami membuat folder baru untuk setiap ekspor).
- Setelah ekspor selesai, kami tidak pernah mengekspor apa pun ke folder itu lagi, karena ekspor berikutnya ke kontainer yang sama akan berada di dalam folder yang baru dibuat.
Untuk mengekspor data ke akun penyimpanan di belakang firewall, lihat Mengonfigurasi pengaturan untuk ekspor.
Pengaturan dan parameter
Header
Ada dua parameter header yang diperlukan yang harus diatur untuk pekerjaan $export. Nilai ditentukan oleh spesifikasi $export saat ini.
- Terima - application/fhir+json
- Lebih suka - respons-asinkron
Parameter kueri
Layanan FHIR mendukung parameter kueri berikut. Semua parameter ini bersifat opsional:
| Parameter kueri | Didefinisikan oleh Spesifikasi FHIR? | Deskripsi |
|---|---|---|
| _outputFormat | Ya | Saat ini mendukung tiga nilai untuk menyelaraskan dengan Spesifikasi FHIR: application/fhir+ndjson, application/ndjson, atau hanya ndjson. Semua pekerjaan ekspor akan kembali ndjson dan nilai yang dilewatkan tidak berpengaruh pada perilaku kode. |
| _since | Ya | Memungkinkan Anda untuk hanya mengekspor sumber daya yang telah dimodifikasi sejak waktu yang disediakan |
| _type | Ya | Memungkinkan Anda menentukan jenis sumber daya mana yang akan disertakan. Misalnya, _type=Pasien hanya akan mengembalikan sumber daya pasien |
| _typeFilter | Ya | Untuk meminta pemfilteran yang lebih halus, Anda dapat menggunakan _typeFilter bersama dengan parameter _type. Nilai parameter _typeFilter adalah daftar kueri FHIR yang dipisahkan koma yang membatasi hasil lebih lanjut |
| _container | Tidak | Menentukan kontainer dalam akun penyimpanan yang dikonfigurasi tempat data harus diekspor. Jika kontainer ditentukan, data akan diekspor ke dalam folder ke dalam kontainer tersebut. Jika kontainer tidak ditentukan, data akan diekspor ke kontainer baru. |
Catatan
Hanya akun penyimpanan dalam langganan yang sama dengan untuk layanan FHIR yang diizinkan untuk didaftarkan sebagai tujuan untuk operasi $export.
Langkah berikutnya
Dalam artikel ini, Anda telah mempelajari cara mengekspor sumber daya FHIR menggunakan perintah $export. Untuk informasi selengkapnya tentang cara menyiapkan dan menggunakan ekspor yang tidak diidentifikasi atau cara mengekspor data dari Azure API untuk FHIR ke Azure Synapse Analytics, lihat
FHIR® adalah merek dagang terdaftar HL7 dan digunakan dengan izin HL7.