Mengekspor data FHIR di Azure API untuk FHIR

Penting

Azure API untuk FHIR akan dihentikan pada 30 September 2026. Ikuti strategi migrasi untuk beralih ke layanan FHIR Azure Health Data Services pada tanggal tersebut. Karena penghentian Azure API untuk FHIR, penyebaran baru tidak akan diizinkan mulai 1 April 2025. Layanan Azure Health Data Services FHIR adalah versi Azure API yang berkembang untuk FHIR yang memungkinkan pelanggan mengelola layanan FHIR, DICOM, dan MedTech dengan integrasi ke layanan Azure lainnya.

Fitur Ekspor Massal memungkinkan data untuk diekspor dari Server FHIR sesuai spesifikasi FHIR.

Sebelum menggunakan $export, Anda ingin memastikan bahwa Azure API untuk FHIR dikonfigurasi untuk menggunakannya. Untuk mengonfigurasi pengaturan ekspor dan membuat akun penyimpanan Azure, lihat halaman konfigurasikan data ekspor.

Catatan

Hanya akun penyimpanan dalam langganan yang sama dengan yang untuk Azure API untuk FHIR yang diizinkan untuk didaftarkan sebagai tujuan untuk operasi $export.

Menggunakan perintah $export

Setelah mengonfigurasi Azure API untuk FHIR untuk diekspor, Anda dapat menggunakan perintah $export untuk 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 ekspor adalah dengan memeriksa akun penyimpanan Anda untuk melihat apakah kontainer yang sesuai (yaitu, ndjson) file 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. Waktu proses default kami untuk ekspor dalam keadaan buruk adalah 10 menit sebelum akan berhenti dan pindah ke pekerjaan baru atau mencoba kembali ekspor.

Azure API For 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>>

Dengan ekspor, data diekspor dalam beberapa file yang masing-masing berisi sumber daya hanya dari satu jenis. Jumlah sumber daya dalam file individual akan dibatasi. Jumlah maksimum sumber daya didasarkan pada performa sistem. Saat ini diatur ke 5.000, tetapi dapat berubah. Hasilnya adalah Anda mungkin mendapatkan beberapa file untuk jenis sumber daya. Nama file akan mengikuti format 'resourceName-number-number.ndjson'. Urutan file tidak dijamin sesuai dengan urutan sumber daya apa pun dalam database.

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 (di mana 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
• Prefer - respond-async

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 selaras dengan Spesifikasi FHIR: application/fhir+ndjson, application/ndjson, atau ndjson. Semua pekerjaan ekspor kembali ndjson dan nilai yang diteruskan tidak berpengaruh pada perilaku kode.
_Sejak	Ya	Memungkinkan Anda 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 selanjutnya membatasi hasil
_Wadah	No	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.
_Sampai	No	Memungkinkan Anda untuk hanya mengekspor sumber daya yang telah dimodifikasi sampai waktu yang disediakan. Parameter ini hanya berlaku untuk ekspor Tingkat Sistem. Dalam hal ini, jika versi historis belum dinonaktifkan atau dihapus menyeluruh, ekspor menjamin tampilan rekam jepret yang sebenarnya, atau, dengan kata lain, memungkinkan perjalanan waktu.
includeAssociatedData	No	Memungkinkan Anda mengekspor riwayat dan sumber daya yang dihapus sementara. Filter ini tidak berfungsi dengan parameter kueri '_typeFilter'. Sertakan nilai sebagai '_history' untuk mengekspor riwayat/sumber daya non versi terbaru. Sertakan nilai sebagai '_deleted' untuk mengekspor sumber daya yang dihapus sementara.
_isparallel	No	Parameter kueri "_isparallel" dapat ditambahkan ke operasi ekspor untuk meningkatkan throughputnya. Nilai perlu diatur ke true untuk mengaktifkan paralelisasi. Penting untuk dicatat bahwa menggunakan parameter ini dapat mengakibatkan peningkatan konsumsi unit permintaan selama masa pakai ekspor.

Catatan

Ada masalah yang diketahui dengan operasi $export yang dapat mengakibatkan ekspor yang tidak lengkap dengan keberhasilan status. Masalah terjadi ketika bendera is_parallel digunakan. Pekerjaan ekspor yang dijalankan dengan parameter kueri _isparallel mulai 13 Februari 2024 terpengaruh dengan masalah ini.

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 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 mengakses akun penyimpanan Azure dari wilayah Azure lainnya

1. Di portal Azure, buka akun Azure Data Lake Storage Gen2.

2. Di menu sebelah kiri, pilih Jaringan.

3. Pilih Diaktifkan dari jaringan virtual dan alamat IP yang dipilih.

4. Di bagian Firewall , dalam kotak Rentang alamat , tentukan alamat IP. Tambahkan rentang IP untuk mengizinkan akses dari internet atau jaringan lokal Anda. Anda dapat menemukan alamat IP dalam tabel berikut untuk wilayah Azure tempat layanan 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
   AS 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
   US Tengah 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
   AS Tengah Bagian Barat	52.150.156.44
   Eropa Barat	20.61.98.66
   US Barat 2	40.64.135.77

Mengizinkan alamat IP tertentu untuk mengakses akun penyimpanan Azure di wilayah yang sama

Proses konfigurasi untuk alamat IP di wilayah yang sama seperti prosedur sebelumnya, kecuali bahwa Anda menggunakan rentang alamat IP tertentu dalam format Classless Inter-Domain Routing (CIDR) sebagai gantinya (yaitu, 100.64.0.0/10). Anda harus menentukan rentang alamat IP (100.64.0.0 hingga 100.127.255.255) karena alamat IP untuk layanan FHIR dialokasikan setiap kali Anda membuat permintaan operasi.

Catatan

Dimungkinkan untuk menggunakan alamat IP privat dalam rentang 10.0.2.0/24, tetapi tidak ada jaminan bahwa operasi akan berhasil dalam kasus seperti itu. Anda dapat mencoba kembali jika permintaan operasi gagal, tetapi sampai Anda menggunakan alamat IP dalam rentang 100.64.0.0/10, permintaan tidak akan berhasil.

Perilaku jaringan untuk rentang alamat IP ini dirancang. 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

Mengekspor data yang tidak diidentifikasi

FHIR® adalah merek dagang terdaftar HL7 dan digunakan dengan izin HL7.