Cara mengekspor data FHIR di Azure API untuk FHIR
Fitur Ekspor Massal memungkinkan data untuk diekspor dari Server FHIR sesuai spesifikasi FHIR.
Sebelum menggunakan $export, Anda harus memastikan bahwa Azure API untuk FHIR dikonfigurasi untuk menggunakannya. Untuk mengonfigurasi pengaturan ekspor dan membuat akun penyimpanan Azure, lihat halaman konfigurasikan data ekspor.
Menggunakan perintah $export
Setelah mengonfigurasi Azure API untuk FHIR untuk ekspor, Anda dapat menggunakan perintah $export untuk mengekspor data 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.
Azure API Untuk 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* - Azure API untuk 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 file yang diekspor tunggal 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.
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
Azure API untuk 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 yang diizinkan untuk Azure API untuk FHIR untuk didaftarkan sebagai tujuan untuk operasi $export.
Ekspor Aman ke Azure Storage
Azure API untuk FHIR mendukung operasi ekspor yang aman. Pilih salah satu dari dua opsi di bawah ini:
Mengizinkan Azure API untuk FHIR sebagai Layanan Tepercaya Microsoft untuk mengakses akun penyimpanan Azure.
Mengizinkan alamat IP tertentu yang terkait dengan Azure API untuk FHIR untuk mengakses akun penyimpanan Azure. Opsi ini menyediakan dua konfigurasi berbeda tergantung pada apakah akun penyimpanan berada di lokasi yang sama dengan, atau berada di lokasi yang berbeda dari Azure API untuk FHIR.
Mengizinkan Azure API untuk FHIR sebagai Layanan Tepercaya Microsoft
Pilih akun penyimpanan dari portal Microsoft Azure, lalu pilih bilah Jaringan . Pilih Jaringan yang dipilih di bawah tab Firewall dan jaringan virtual .
Penting
Pastikan Anda telah memberikan izin akses ke akun penyimpanan untuk Azure API untuk FHIR menggunakan identitas terkelolanya. Untuk informasi selengkapnya, lihat Mengonfigurasi pengaturan ekspor dan menyiapkan akun penyimpanan.
Di bawah bagian Pengecualian , pilih kotak Izinkan layanan Microsoft tepercaya untuk mengakses akun penyimpanan ini dan simpan pengaturan.
Anda sekarang siap untuk mengekspor data FHIR ke akun penyimpanan dengan aman. Perhatikan bahwa akun penyimpanan berada di jaringan yang dipilih dan tidak dapat diakses secara publik. Untuk mengakses file, Anda dapat mengaktifkan dan menggunakan titik akhir privat untuk akun penyimpanan, atau mengaktifkan semua jaringan untuk akun penyimpanan untuk waktu yang singkat.
Penting
Antarmuka pengguna akan diperbarui nanti untuk memungkinkan Anda memilih jenis Sumber Daya untuk Azure API untuk FHIR dan instans layanan tertentu.
Mengizinkan alamat IP tertentu untuk akun penyimpanan Azure di wilayah yang berbeda
Pilih Jaringan akun penyimpanan Azure dari portal.
Pilih Jaringan yang dipilih. Di bawah bagian Firewall, tentukan alamat IP dalam kotak Rentang alamat . Tambahkan rentang IP untuk mengizinkan akses dari internet atau jaringan lokal Anda. Anda dapat menemukan alamat IP dalam tabel di bawah ini untuk wilayah Azure tempat Azure API untuk FHIR disediakan.
| Wilayah Azure | Alamat IP Publik |
|---|---|
| Australia Timur | 20.53.44.80 |
| Kanada Tengah | 20.48.192.84 |
| US Tengah | 52.182.208.31 |
| AS Timur | 20.62.128.148 |
| US Timur 2 | 20.49.102.228 |
| US Timur 2 EUAP | 20.39.26.254 |
| Jerman Utara | 51.116.51.33 |
| Jerman Barat Tengah | 51.116.146.216 |
| Jepang Timur | 20.191.160.26 |
| Korea Tengah | 20.41.69.51 |
| US Tengah Utara | 20.49.114.188 |
| Eropa Utara | 52.146.131.52 |
| Afrika Selatan Utara | 102.133.220.197 |
| AS Tengah Bagian Selatan | 13.73.254.220 |
| Asia Tenggara | 23.98.108.42 |
| Swiss Utara | 51.107.60.95 |
| UK Selatan | 51.104.30.170 |
| UK Barat | 51.137.164.94 |
| Barat Sentral AS | 52.150.156.44 |
| Eropa Barat | 20.61.98.66 |
| US Barat 2 | 40.64.135.77 |
Catatan
Langkah-langkah di atas mirip dengan langkah-langkah konfigurasi yang dijelaskan dalam dokumen Cara mengonversi data ke FHIR (Pratinjau). Untuk informasi selengkapnya, lihat Menghosting dan menggunakan templat
Mengizinkan alamat IP tertentu untuk akun penyimpanan Azure di wilayah yang sama
Proses konfigurasi sama seperti di atas kecuali rentang alamat IP tertentu dalam format CIDR digunakan sebagai gantinya, 100.64.0.0/10. Alasan mengapa rentang alamat IP, yang mencakup 100.64.0.0 – 100.127.255.255, harus ditentukan adalah karena alamat IP aktual yang digunakan oleh layanan bervariasi, tetapi akan berada dalam rentang, untuk setiap permintaan $export.
Catatan
Ada kemungkinan bahwa alamat IP privat dalam rentang 10.0.2.0/24 dapat digunakan sebagai gantinya. Dalam hal ini, operasi $export tidak akan berhasil. Anda dapat mencoba kembali permintaan $export, tetapi tidak ada jaminan bahwa alamat IP dalam rentang 100.64.0.0/10 akan digunakan di lain waktu. Itulah perilaku jaringan yang diketahui berdasarkan desain. Alternatifnya adalah mengonfigurasi akun penyimpanan di wilayah yang berbeda.
Langkah berikutnya
Dalam artikel ini, Anda telah mempelajari cara mengekspor sumber daya FHIR menggunakan perintah $export. Selanjutnya, untuk mempelajari cara mengekspor data yang tidak diidentifikasi, lihat
FHIR® adalah merek dagang terdaftar HL7 dan digunakan dengan izin HL7.