FHIR için Azure API'de FHIR verilerini dışarı aktarma
Önemli
FHIR İçin Azure API'si 30 Eylül 2026 tarihinde kullanımdan kaldırılacaktır. Bu tarihe kadar Azure Health Data Services FHIR hizmetine geçiş yapmak için geçiş stratejilerini izleyin. FHIR İçin Azure API'sinin kullanımdan kaldırılması nedeniyle 1 Nisan 2025 tarihinden itibaren yeni dağıtımlara izin verilmeyecektir. Azure Health Data Services FHIR hizmeti , müşterilerin FHIR, DICOM ve MedTech hizmetlerini diğer Azure hizmetleriyle tümleştirmelerle yönetmesine olanak tanıyan FHIR için Azure API'sinin gelişmiş sürümüdür.
Toplu Dışarı Aktarma özelliği FHIR belirtimine uygun olarak verilerin FHIR Sunucusundan dışarı aktarılmasına olanak tanır.
$export kullanmadan önce, FHIR için Azure API'sinin bunu kullanacak şekilde yapılandırıldığından emin olmak istiyorsunuz. Dışarı aktarma ayarlarını yapılandırmak ve Azure depolama hesabı oluşturmak için dışarı aktarma verilerini yapılandırma sayfasına bakın.
Not
Yalnızca FHIR için Azure API ile aynı abonelikteki depolama hesaplarının $export işlemleri için hedef olarak kaydedilmesine izin verilir.
$export komutunu kullanma
Dışarı aktarma için FHIR için Azure API'sini yapılandırdıktan sonra, verileri hizmet dışında dışarı aktarmak için $export komutunu kullanabilirsiniz. Veriler dışarı aktarma yapılandırılırken belirttiğiniz depolama hesabında depolanır. FHIR sunucusunda $export komutunu çağırmayı öğrenmek için HL7 FHIR $export belirtimindeki belgeleri okuyun.
İşler hatalı durumda takıldı
Bazı durumlarda, bir işin kötü durumda takılma olasılığı vardır. Bu durum özellikle depolama hesabı izinleri düzgün ayarlanmamışsa oluşabilir. Dışarı aktarmayı doğrulamanın bir yolu, ilgili kapsayıcı (yani ndjson) dosyalarının mevcut olup olmadığını görmek için depolama hesabınızı denetlemektir. Bunlar yoksa ve çalışan başka dışarı aktarma işi yoksa, geçerli işin hatalı durumda takılma olasılığı vardır. İptal isteği göndererek dışarı aktarma işini iptal etmeli ve işi yeniden sorgulamayı denemelisiniz. Hatalı durumdaki bir dışarı aktarma için varsayılan çalışma süremiz, durdurulup yeni bir işe taşınmadan veya dışarı aktarmayı yeniden denemeden önce 10 dakikadır.
FHIR için Azure API aşağıdaki düzeylerde $export destekler:
- Sistem:
GET https://<<FHIR service base URL>>/$export>> - Hasta:
GET https://<<FHIR service base URL>>/Patient/$export>> - Hasta grubu* - FHIR için Azure API tüm ilgili kaynakları dışarı aktarır ancak grubun özelliklerini dışarı aktarmaz:
GET https://<<FHIR service base URL>>/Group/[ID]/$export>>
Dışarı aktarma işlemiyle, veriler her biri tek türde kaynaklar içeren birden çok dosyada dışarı aktarılır. Tek bir dosyadaki kaynak sayısı sınırlı olacaktır. Kaynak sayısı üst sınırı, sistem performansına bağlıdır. Şu anda 5.000 olarak ayarlanmıştır, ancak değişebilir. Sonuç olarak, bir kaynak türü için birden çok dosya alabilirsiniz. Dosya adları 'resourceName-number-number.ndjson' biçimini izler. Dosyaların sırasının, veritabanındaki kaynakların herhangi bir sırasına karşılık gelen olması garanti değildir.
Not
Patient/$export ve Group/[ID]/$export kaynak birden fazla kaynağın bölmesindeyse veya birden çok gruptaysa yinelenen kaynakları dışarı aktarabilir.
Ayrıca, sıralama sırasında konum üst bilgisi tarafından döndürülen URL aracılığıyla dışarı aktarma durumunun denetlenilmesi ve gerçek dışarı aktarma işinin iptali desteklenir.
FHIR verilerini ADLS 2. Nesil'e aktarma
Şu anda ADLS 2. Nesil özellikli depolama hesapları için aşağıdaki sınırlamalarla $export destekliyoruz:
- Kullanıcı hiyerarşik ad alanlarını kullanamaz, ancak kapsayıcı içindeki belirli bir alt dizine dışarı aktarmayı hedeflemenin bir yolu yoktur. Yalnızca belirli bir kapsayıcıyı hedefleme olanağı sağlarız (burada her dışarı aktarma için yeni bir klasör oluştururuz).
- Dışarı aktarma işlemi tamamlandıktan sonra, aynı kapsayıcıya yapılan sonraki dışarı aktarma işlemleri yeni oluşturulan bir klasörün içinde olacağından hiçbir şeyi bu klasöre bir daha dışarı aktarmayız.
Ayarlar ve parametreler
Üst Bilgiler
$export işleri için ayarlanması gereken iki gerekli üst bilgi parametresi vardır. Değerler geçerli $export belirtimi tarafından tanımlanır.
- Accept - application/fhir+json
- Tercih - yanıt-zaman uyumsuz
Sorgu parametreleri
FHIR için Azure API aşağıdaki sorgu parametrelerini destekler. Bu parametrelerin tümü isteğe bağlıdır:
| Sorgu parametresi | FHIR Belirtimi tarafından tanımlandı mı? | Açıklama |
|---|---|---|
| _outputFormat | Yes | Şu anda FHIR Belirtimine hizalamak için üç değeri destekler: application/fhir+ndjson, application/ndjson veya ndjson. Tüm dışarı aktarma işleri döndürür ndjson ve geçirilen değerin kod davranışı üzerinde hiçbir etkisi yoktur. |
| _Beri | Yes | Yalnızca belirtilen süreden bu yana değiştirilmiş olan kaynakları dışarı aktarmanıza olanak tanır |
| _Türü | Yes | Dahil edilecek kaynak türlerini belirtmenize olanak tanır. Örneğin, _type=Patient yalnızca hasta kaynaklarını döndürür |
| _typefilter | Yes | Daha ayrıntılı filtreleme istemek için _type parametresiyle birlikte _typefilter kullanabilirsiniz. _typeFilter parametresinin değeri, sonuçları daha da kısıtlayan, virgülle ayrılmış bir FHIR sorguları listesidir |
| _Kapsayıcı | Hayır | Verilerin dışarı aktarılacağı yapılandırılmış depolama hesabı içindeki kapsayıcıyı belirtir. Bir kapsayıcı belirtilirse, veriler bir klasöre bu kapsayıcıya aktarılır. Kapsayıcı belirtilmezse veriler yeni bir kapsayıcıya aktarılır. |
| _Kadar | Hayır | Yalnızca belirtilen zamana kadar değiştirilmiş olan kaynakları dışarı aktarmanıza olanak tanır. Bu parametre yalnızca Sistem Düzeyinde dışarı aktarma için geçerlidir. Bu durumda, geçmiş sürümler devre dışı bırakılmadıysa veya temizlenmezse dışarı aktarma gerçek anlık görüntü görünümünü garanti eder veya başka bir deyişle zaman yolculuğu sağlar. |
| includeAssociatedData | Hayır | Geçmişi ve geçici olarak silinen kaynakları dışarı aktarmanıza olanak tanır. Bu filtre '_typeFilter' sorgu parametresiyle çalışmaz. Geçmişi/en son sürüme sahip olmayan kaynakları dışarı aktarmak için değeri '_history' olarak ekleyin. Geçici olarak silinen kaynakları dışarı aktarmak için değeri '_deleted' olarak ekleyin. |
| _isparallel | Hayır | Aktarım hızını artırmak için dışarı aktarma işlemine "_isparallel" sorgu parametresi eklenebilir. Paralelleştirmeyi etkinleştirmek için değerin true olarak ayarlanması gerekir. Bu parametrenin kullanılması, dışarı aktarma süresi boyunca istek birimi tüketiminde artışa neden olabilir. |
Not
$export işlemiyle ilgili bilinen bir sorun var ve bu durum başarılı olan eksik dışarı aktarmalara neden olabilir. Sorun, is_parallel bayrağı kullanıldığında oluşur. 13 Şubat 2024'den itibaren _isparallel sorgu parametresiyle yürütülen dışarı aktarma işleri bu sorundan etkilenir.
Azure Depolama Güvenli Dışarı Aktarma
FHIR için Azure API güvenli dışarı aktarma işlemini destekler. Aşağıdaki iki seçenek arasında seçim yapın:
Microsoft Güvenilen Hizmeti olarak FHIR için Azure API'sinin Azure depolama hesabına erişmesine izin verme.
FHIR için Azure API ile ilişkili belirli IP adreslerinin Azure depolama hesabına erişmesine izin verme. Bu seçenek, depolama hesabının FHIR için Azure API'sinin konumuyla aynı konumda veya farklı bir konumda olmasına bağlı olarak iki farklı yapılandırma sağlar.
Microsoft Güvenilen Hizmet olarak FHIR için Azure API'ye izin verme
Azure portalından bir depolama hesabı seçin ve ardından Ağ dikey penceresini seçin. Güvenlik duvarları ve sanal ağlar sekmesinde Seçili ağlar'ı seçin.
Önemli
Yönetilen kimliğini kullanarak FHIR için Azure API depolama hesabına erişim izni verdiğinden emin olun. Daha fazla bilgi için bkz . Dışarı aktarma ayarını yapılandırma ve depolama hesabını ayarlama.
Özel Durumlar bölümünde Güvenilen Microsoft hizmetleri bu depolama hesabına erişmesine izin ver kutusunu seçin ve ayarı kaydedin.
Artık FHIR verilerini güvenli bir şekilde depolama hesabına aktarmaya hazırsınız. Depolama hesabının seçili ağlarda olduğunu ve genel olarak erişilebilir olmadığını unutmayın. Dosyalara erişmek için depolama hesabı için özel uç noktaları etkinleştirebilir ve kullanabilir veya depolama hesabı için tüm ağları kısa bir süre için etkinleştirebilirsiniz.
Önemli
Kullanıcı arabirimi daha sonra FHIR için Azure API'sinin Kaynak türünü ve belirli bir hizmet örneğini seçmenize olanak tanıyacak şekilde güncelleştirilir.
Belirli IP adreslerinin diğer Azure bölgelerinden Azure depolama hesabına erişmesine izin ver
Azure portalında Azure Data Lake Storage 2. Nesil hesabına gidin.
Soldaki menüde Ağ'ı seçin.
Seçili sanal ağlardan ve IP adreslerinden Etkin'i seçin.
Güvenlik Duvarı bölümündeki Adres aralığı kutusunda IP adresini belirtin. İnternet'ten veya şirket içi ağlarınızdan erişime izin vermek için IP aralıkları ekleyin. IP adresini FHIR hizmetinin sağlandığı Azure bölgesi için aşağıdaki tabloda bulabilirsiniz.
Azure bölgesi Genel IP adresi Doğu Avustralya 20.53.44.80 Orta Kanada 20.48.192.84 Orta ABD 52.182.208.31 Doğu ABD 20.62.128.148 Doğu ABD 2 20.49.102.228 Doğu ABD 2 EUAP 20.39.26.254 Almanya Kuzey 51.116.51.33 Orta Batı Almanya 51.116.146.216 Doğu Japonya 20.191.160.26 Güney Kore - Orta 20.41.69.51 Orta Kuzey ABD 20.49.114.188 Kuzey Avrupa 52.146.131.52 Güney Afrika Kuzey 102.133.220.197 Orta Güney ABD 13.73.254.220 Güneydoğu Asya 23.98.108.42 Kuzey İsviçre 51.107.60.95 Güney Birleşik Krallık 51.104.30.170 Batı Birleşik Krallık 51.137.164.94 Batı Orta ABD 52.150.156.44 West Europe 20.61.98.66 Batı ABD 2 40.64.135.77
Belirli IP adreslerinin aynı bölgedeki Azure depolama hesabına erişmesine izin ver
Aynı bölgedeki IP adresleri için yapılandırma işlemi önceki yordama benzer, ancak bunun yerine Sınıfsız Etki Alanları Arası Yönlendirme (CIDR) biçiminde (100.64.0.0/10) belirli bir IP adresi aralığı kullanmanız gerekir. her işlem isteğinde olduğunuzda FHIR hizmeti için bir IP adresi ayrıldığından IP adres aralığını (100.64.0.0 ile 100.127.255.255) belirtmeniz gerekir.
Not
10.0.2.0/24 aralığında özel bir IP adresi kullanmak mümkündür, ancak bu durumda işlemin başarılı olacağı garanti edilmez. İşlem isteği başarısız olursa yeniden deneyebilirsiniz, ancak 100.64.0.0/10 aralığında bir IP adresi kullanana kadar istek başarılı olmaz.
IP adresi aralıkları için bu ağ davranışı tasarım gereğidir. Alternatif olarak depolama hesabını farklı bir bölgede yapılandırabilirsiniz.
Sonraki adımlar
Bu makalede, $export komutunu kullanarak FHIR kaynaklarını dışarı aktarmayı öğrendiniz. Ardından, tanımsız verilerin nasıl dışarı aktarıldığını öğrenmek için bkz.
FHIR®, HL7'nin tescilli ticari markasıdır ve HL7'nin izniyle kullanılır.