FHIR verilerinizi dışarı aktarma
FHIR hizmetinde toplu $export işlemi kullanarak verileri HL7 FHIR Toplu Veri Erişimi belirtiminde açıklandığı gibi dışarı aktarabilirsiniz.
kullanmaya $exportçalışmadan önce FHIR hizmetinizin bir Azure Data Lake Storage 2. Nesil hesabıyla bağlanacak şekilde yapılandırıldığından emin olun. Dışarı aktarma ayarlarını yapılandırmak ve bir Data Lake Storage 2. Nesil hesabı oluşturmak için Dışarı aktarma ayarlarını yapılandırma bölümüne bakın.
$export Uç noktayı çağırma
FHIR hizmetini bir Data Lake Storage 2. Nesil hesabıyla bağlanacak şekilde ayarladıktan sonra uç noktayı çağırabilirsiniz $export ve FHIR hizmeti verileri depolama hesabının içindeki bir Azure Blob Depolama kapsayıcısına aktarır. Aşağıdaki örnek istek, tüm kaynakları ad ({{containerName}} ) ile belirtilen bir kapsayıcıya aktarır. İstekte belirtmek {{containerName}} istiyorsanız kapsayıcıyı önceden Data Lake Storage 2. Nesil hesabında oluşturmanız gerektiğini unutmayın.
GET {{fhirurl}}/$export?_container={{containerName}}
İstekte bir kapsayıcı adı belirtmezseniz (örneğin, çağırarak GET {{fhirurl}}/$export), dışarı aktarılan veriler için otomatik olarak oluşturulan ada sahip yeni bir kapsayıcı oluşturulur.
FHIR $export API belirtimi hakkında genel bilgi için HL7 FHIR Dışarı Aktarma İsteği Akışı belgelerine bakın.
FHIR hizmeti aşağıdaki düzeylerde destekler $export :
- Sistem:
GET {{fhirurl}}/$export - Hasta:
GET {{fhirurl}}/Patient/$export - Hasta grubu*:
GET {{fhirurl}}/Group/[ID]/$export
*FHIR hizmeti başvuruda bulunan tüm kaynakları dışarı aktarır ancak grup kaynağının özelliklerini dışarı aktarmaz.
Veriler birden çok dosyada dışarı aktarılır. Her dosya yalnızca bir tür kaynak içerir. 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ı biçimine <resourceName>-<number>-<number>.ndjsonuyar. Dosyaların sırasının veritabanındaki kaynakların herhangi bir sırasına karşılık gelen garanti değildir.
Not
Patient/$export ve Group/[ID]/$export bir kaynak birden çok grupta veya birden fazla kaynağın bölmesindeyse yinelenen kaynakları dışarı aktarabilir.
Depolama hesabınızda dışarı aktarılan dosyaların varlığını denetlemeye ek olarak, FHIR hizmet yanıtında döndürülen üst bilgideki Content-Location URL aracılığıyla işlem durumunuzu $export de kontrol edebilirsiniz. Daha fazla bilgi için HL7'nin Toplu Veri Durumu İsteği belgelerine bakın.
FHIR verilerinizi Data Lake Storage 2. Nesil dışarı aktarma
FHIR hizmeti şu anda aşağıdaki sınırlamalarla hesapları Data Lake Storage 2. Nesil destekler$export:
- Data Lake Storage 2. Nesil hiyerarşik ad alanları sağlar, ancak işlemleri kapsayıcı içindeki belirli bir alt dizine hedeflemenin
$exportbir yolu yoktur. FHIR hizmeti yalnızca dışarı aktarma için hedef kapsayıcıyı belirtebilir ve burada her$exportişlem için yeni bir klasör oluşturulur. - bir
$exportişlem tamamlandıktan ve tüm veriler bir klasörün içine yazıldıktan sonra, aynı kapsayıcıya yapılan sonraki dışarı aktarmalar yeni oluşturulan bir klasörün içinde olacağı için FHIR hizmeti bu klasöre bir daha hiçbir şey aktarmaz.
Güvenlik duvarının arkasındaki bir depolama hesabına veri aktarmak için bkz . Dışarı aktarma ayarlarını yapılandırma.
Ayarlar ve parametreler
Üst Bilgiler
İşler için $export iki gerekli üst bilgi parametresi ayarlanmalıdır. Değerler geçerli HL7 $export belirtimine göre ayarlanır.
- Kabul Et:
application/fhir+json - Tercih:
respond-async
Sorgu parametreleri
FHIR hizmeti, dışarı aktarılan verileri filtrelemek için aşağıdaki sorgu parametrelerini destekler. Tüm bu parametreler isteğe bağlıdır.
| Sorgu parametresi | FHIR belirtimi tarafından tanımlandı mı? | Açıklama |
|---|---|---|
_outputFormat |
Yes | Şu anda FHIR belirtimine göre hizalamak için üç değeri destekler: application/fhir+ndjson, application/ndjsonveya yalnızca ndjson. Tüm dışarı aktarma işleri dosyaları döndürür .ndjson ve geçirilen değerin kod davranışı üzerinde hiçbir etkisi yoktur. |
_since |
Yes | Yalnızca belirtilen süreden bu yana değiştirilmiş olan kaynakları dışarı aktarmanıza olanak tanır. |
_type |
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 parametresiyle _type birlikte kullanabilirsiniz_typeFilter. parametresinin _typeFilter değeri, sonuçları daha fazla sınırlayan FHIR sorgularının virgülle ayrılmış bir listesidir. |
_container |
Hayır | Verilerin dışarı aktarılacağı yapılandırılmış depolama hesabında kapsayıcının adını belirtir. Bir kapsayıcı belirtilirse, veriler bu kapsayıcıdaki bir klasöre aktarılır. Kapsayıcı belirtilmezse, veriler otomatik olarak oluşturulan bir ada sahip yeni bir kapsayıcıya aktarılır. |
_till |
Hayır | Belirtilen zamana kadar değiştirilmiş kaynakları dışarı aktarmanıza olanak tanır. Bu parametre yalnızca Sistem Düzeyinde dışarı aktarma ile geçerlidir. Bu durumda, geçmiş sürümler devre dışı bırakılmadıysa veya temizlenmediyse, 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. |
Not
Yalnızca FHIR hizmetiyle aynı abonelikteki depolama hesaplarının işlemler için $export hedef olarak kaydedilmesine izin verilir.
Sorun giderme
Aşağıdaki bilgiler FHIR verilerini dışarı aktarmayla ilgili sorunları çözmenize yardımcı olabilir.
İşler hatalı durumda takıldı
Bazı durumlarda, FHIR hizmeti verileri dışarı aktarmaya çalışırken işin hatalı durumda takılması olasıdır. Bu durum özellikle Data Lake Storage 2. Nesil hesabı izinleri doğru ayarlanmamışsa oluşabilir.
İşleminizin $export durumunu denetlemenin bir yolu, depolama hesabınızın depolama tarayıcısına gitmek ve dışarı aktarma kapsayıcısında herhangi bir .ndjson dosya olup olmadığını görmektir. Dosyalar mevcut değilse ve başka $export hiçbir iş çalışmıyorsa, geçerli iş hatalı durumda takılmış olabilir. Bu durumda, FHIR hizmet API'sini $export bir DELETE istekle çağırarak işi iptal edebilirsiniz. Daha sonra işi yeniden sorgulayabilir $export ve yeniden deneyebilirsiniz.
Bir $export işlemi iptal etme hakkında daha fazla bilgi için HL7'den Toplu Veri Silme İsteği belgelerine bakın.
Not
FHIR hizmetinde, bir işlemin hatalı durumda boşta olması için $export varsayılan süre, hizmetin işlemi durdurması ve yeni bir işe geçmesi için 10 dakikadır.
Sonraki adımlar
Bu makalede, işlemi kullanarak FHIR kaynaklarını dışarı aktarma hakkında $export bilgi edindiniz. Dışarı aktarma için ek seçenekleri ayarlama ve kullanma hakkında bilgi için bkz:
FHIR®, HL7'nin tescilli ticari markasıdır ve HL7'nin izniyle kullanılır.