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, verilerin FHIR belirtimi başına FHIR® Sunucusundan dışarı aktarılmasını sağlar.
kullanmadan $exportönce FHIR için Azure API'sinin bunu kullanacak şekilde yapılandırıldığından emin olun. 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
FHIR için Azure API'yi dışarı aktarma için yapılandırdıktan sonra, verileri hizmet dışında dışarı aktarmak için komutunu kullanabilirsiniz $export . Veriler dışarı aktarma yapılandırılırken belirttiğiniz depolama hesabında depolanır. FHIR sunucusunda komutu çağırmayı $export öğrenmek için HL7 FHIR $export belirtimindeki belgeleri okuyun.
İşler hatalı durumda takıldı
Bazı durumlarda, bir iş kötü durumda takılabilir. Depolama hesabı izinleri düzgün ayarlanmamışsa bu durum 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ş hatalı durumda takılmış olabilir. İ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 destekler $export :
- 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>>
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çimindedir. 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ını aşağıdaki sınırlamalarla destekliyoruz $export :
- Kullanıcılar hiyerarşik ad alanlarının avantajlarından yararlanamaz; 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ğlıyoruz (her dışarı aktarma için yeni bir klasör oluşturulur).
- Dışarı aktarma işlemi tamamlandıktan sonra hiçbir şey bu klasöre bir daha dışarı aktarılmış olmaz. Aynı kapsayıcıya yapılan sonraki dışarı aktarmalar yeni oluşturulan bir klasörün içinde olacaktır.
Ayarlar ve parametreler
Üst Bilgiler
İşler için $export 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=Hasta 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 FHIR sorgularının virgülle ayrılmış bir listesidir. |
| _konteyner | Hayır | Verilerin dışarı aktarılacağı yapılandırılmış depolama hesabı içindeki kapsayıcıyı belirtir. Bir kapsayıcı belirtilirse, veriler bu kapsayıcıdaki bir klasöre 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ş 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 işlemi gerçek bir anlık görüntü görünümünü garanti eder. 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ş (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. Not: Bu parametrenin kullanılması, dışarı aktarma süresi boyunca istek birimi tüketiminde artışa neden olabilir. |
Not
İşlemde $export durum başarılı olan eksik dışarı aktarmalara neden olabilecek bilinen bir sorun vardır. 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'ya 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ından birini belirleyin.
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 ile aynı veya farklı 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. Not: Depolama hesabı seçili ağlardadır ve genel olarak erişilebilir değildir. 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, komutunu kullanarak $export FHIR kaynaklarını dışarı aktarmayı öğrendiniz. Ardından, tanımsız verilerin nasıl dışarı aktarıldığını öğrenmek için bkz.