Exportera FHIR-data i Azure API för FHIR
Viktigt!
Azure API för FHIR avvecklas den 30 september 2026. Följ migreringsstrategierna för att övergå till Azure Health Data Services FHIR-tjänsten® senast det datumet. På grund av tillbakadragandet av Azure API för FHIR tillåts inte nya distributioner från och med den 1 april 2025. Azure Health Data Services FHIR-tjänsten är den utvecklade versionen av Azure API för FHIR som gör det möjligt för kunder att hantera FHIR-, DICOM- och MedTech-tjänster med integreringar i andra Azure-tjänster.
Med funktionen Massexport kan data exporteras från FHIR-servern® enligt FHIR-specifikationen.
Innan du använder $exportkontrollerar du att Azure API för FHIR är konfigurerat att använda det. Information om hur du konfigurerar exportinställningar och skapar ett Azure Storage-konto finns på sidan konfigurera exportdata.
Kommentar
Endast lagringskonton i samma prenumeration som för Azure API för FHIR får registreras som mål för $export åtgärder.
Använda kommandot $export
När du har konfigurerat Azure API för FHIR för export kan du använda $export kommandot för att exportera data från tjänsten. Data lagras i det lagringskonto som du angav när du konfigurerade export. Läs dokumentationen i HL7 FHIR-$export-specifikationen $exportför att lära dig hur du anropar kommandot i FHIR-servern.
Jobb som fastnat i ett felaktigt tillstånd
I vissa situationer kan ett jobb fastna i ett felaktigt tillstånd. Detta kan inträffa om lagringskontobehörigheterna inte har konfigurerats korrekt. Ett sätt att verifiera en export är att kontrollera lagringskontot för att se om motsvarande containerfiler (dvs ndjson. ) finns. Om de inte finns och det inte finns några andra exportjobb som körs är det möjligt att det aktuella jobbet har fastnat i ett felaktigt tillstånd. Du bör avbryta exportjobbet genom att skicka en begäran om annullering och försöka skicka jobbet igen. Vår standardkörningstid för en export i felaktigt tillstånd är 10 minuter innan den stoppas och flyttas till ett nytt jobb eller försöker exportera igen.
Azure API för FHIR stöder $export på följande nivåer:
- System:
GET https://<<FHIR service base URL>>/$export>> - Patient:
GET https://<<FHIR service base URL>>/Patient/$export>> - Grupp av patienter* – Azure API för FHIR exporterar alla relaterade resurser men exporterar inte gruppens egenskaper:
GET https://<<FHIR service base URL>>/Group/[ID]/$export>>
Data exporteras i flera filer, var och en innehåller resurser av endast en typ. Antalet resurser i en enskild fil begränsas. Det maximala antalet resurser baseras på systemprestanda. Den är för närvarande inställd på 5 000, men kan ändras. Resultatet är att du kan få flera filer för en resurstyp. Filnamnen följer formatet "resourceName-number-number.ndjson". Ordningen på filerna är inte garanterad att motsvara någon ordning på resurserna i databasen.
Kommentar
Patient/$export och Group/[ID]/$export kan exportera duplicerade resurser om resursen finns i ett fack med mer än en resurs eller finns i flera grupper.
Dessutom stöds kontroll av exportstatus via den URL som returnerades av platsrubriken under köerna, tillsammans med att det faktiska exportjobbet avbröts.
Exportera FHIR-data till ADLS Gen2
För närvarande stöder $export vi för ADLS Gen2-aktiverade lagringskonton med följande begränsningar:
- Användare kan inte dra nytta av hierarkiska namnområden – det finns inget sätt att rikta en export till en specifik underkatalog i en container. Vi ger bara möjlighet att rikta in oss på en specifik container (där en ny mapp skapas för varje export).
- När en export är klar exporteras ingenting någonsin till den mappen igen. Efterföljande exporter till samma container kommer att finnas i en nyligen skapad mapp.
Inställningar och parametrar
Sidhuvuden
Det finns två obligatoriska rubrikparametrar som måste anges för $export jobb. Värdena definieras av den aktuella $export specifikationen.
- Acceptera – program/fhir+json
- Föredrar – svara-asynkron
Frågeparametrar
Azure API för FHIR stöder följande frågeparametrar. Alla dessa parametrar är valfria.
| Frågeparameter | Definieras av FHIR-specifikationen? | beskrivning |
|---|---|---|
| _outputFormat | Ja | Stöder för närvarande tre värden för att justera till FHIR-specifikationen: application/fhir+ndjson, application/ndjson eller ndjson. Alla exportjobb returneras ndjson och det överförda värdet påverkar inte kodbeteendet. |
| _sedan | Ja | Gör att du bara kan exportera resurser som har ändrats sedan den angivna tiden. |
| _typ | Ja | Gör att du kan ange vilka typer av resurser som ska ingå. Till exempel returnerar _type=Patient endast patientresurser. |
| _typefilter | Ja | Om du vill begära finkornig filtrering kan du använda _typefilter tillsammans med parametern _type. Värdet för parametern _typeFilter är en kommaavgränsad lista över FHIR-frågor som ytterligare begränsar resultatet. |
| _behållare | Nej | Anger containern i det konfigurerade lagringskontot där data ska exporteras. Om en container har angetts exporteras data till en mapp i containern. Om containern inte har angetts exporteras data till en ny container. |
| _tills | Nej | Gör att du bara kan exportera resurser som har ändrats fram till den angivna tiden. Den här parametern gäller endast för export på systemnivå. I det här fallet, om historiska versioner inte har inaktiverats eller rensats, garanterar export en sann ögonblicksbildvy. Med andra ord möjliggör tidsresor. |
| includeAssociatedData | Nej | Gör att du kan exportera historik och mjuka borttagna resurser. Det här filtret fungerar inte med frågeparametern "_typeFilter". Inkludera värdet som "_history" för att exportera historikresurser (icke-senast versionerade). Inkludera värdet som "_deleted" för att exportera mjukt borttagna resurser. |
| _isparallel | Nej | Frågeparametern "_isparallel" kan läggas till i exportåtgärden för att förbättra dess dataflöde. Värdet måste anges till true för att möjliggöra parallellisering. Obs! Om du använder den här parametern kan förbrukningen av begärandeenheter öka under exportens livslängd. |
Kommentar
Det finns ett känt problem med åtgärden $export som kan leda till ofullständiga exporter med status lyckades. Problemet uppstår när flaggan is_parallel användes. Exportjobb som körs med _isparallel frågeparameter från och med den 13 februari 2024 påverkas av det här problemet.
Säker export till Azure Storage
Azure API för FHIR stöder en säker exportåtgärd. Välj något av följande två alternativ.
Tillåta att Azure API för FHIR som en Betrodd Microsoft-tjänst får åtkomst till Azure-lagringskontot.
Tillåta att specifika IP-adresser som är associerade med Azure API för FHIR får åtkomst till Azure Storage-kontot. Det här alternativet innehåller två olika konfigurationer beroende på om lagringskontot finns på samma eller annan plats som Azure API för FHIR.
Tillåta Azure API för FHIR som en Betrodd Microsoft-tjänst
Välj ett lagringskonto från Azure Portal och välj sedan bladet Nätverk. Välj Valda nätverk under fliken Brandväggar och virtuella nätverk .
Viktigt!
Kontrollera att du har beviljat åtkomstbehörighet till lagringskontot för Azure API för FHIR med dess hanterade identitet. Mer information finns i Konfigurera exportinställning och konfigurera lagringskontot.
Under avsnittet Undantag väljer du rutan Tillåt betrodda Microsoft-tjänster att komma åt det här lagringskontot och spara inställningen.
Nu är du redo att exportera FHIR-data till lagringskontot på ett säkert sätt. Obs! Lagringskontot finns i valda nätverk och är inte offentligt tillgängligt. För att komma åt filerna kan du antingen aktivera och använda privata slutpunkter för lagringskontot eller aktivera alla nätverk för lagringskontot under en kort tidsperiod.
Viktigt!
Användargränssnittet uppdateras senare så att du kan välja resurstyp för Azure API för FHIR och en specifik tjänstinstans.
Tillåt att specifika IP-adresser får åtkomst till Azure Storage-kontot från andra Azure-regioner
I Azure Portal går du till Azure Data Lake Storage Gen2-kontot.
Välj Nätverk på den vänstra menyn.
Välj Aktiverad från valda virtuella nätverk och IP-adresser.
I avsnittet Brandvägg i rutan Adressintervall anger du IP-adressen. Lägg till IP-intervall för att tillåta åtkomst från Internet eller dina lokala nätverk. Du hittar IP-adressen i följande tabell för Den Azure-region där FHIR-tjänsten etableras.
Azure-region Offentlig IP-adress Australien, östra 20.53.44.80 Kanada, centrala 20.48.192.84 Centrala USA 52.182.208.31 USA, östra 20.62.128.148 USA, östra 2 20.49.102.228 Östra USA 2 EUAP 20.39.26.254 Tyskland, norra 51.116.51.33 Tyskland, västra centrala 51.116.146.216 Japan, östra 20.191.160.26 Sydkorea, centrala 20.41.69.51 Norra centrala USA 20.49.114.188 Europa, norra 52.146.131.52 Sydafrika, norra 102.133.220.197 USA, södra centrala 13.73.254.220 Sydostasien 23.98.108.42 Schweiz, norra 51.107.60.95 Södra Storbritannien 51.104.30.170 Västra Storbritannien 51.137.164.94 Västra centrala USA 52.150.156.44 Västeuropa 20.61.98.66 Västra USA 2 40.64.135.77
Tillåt att specifika IP-adresser får åtkomst till Azure Storage-kontot i samma region
Konfigurationsprocessen för IP-adresser i samma region är precis som föregående procedur, förutom att du använder ett specifikt IP-adressintervall i CIDR-format (Classless Inter-Domain Routing) i stället (dvs. 100.64.0.0/10). Du måste ange IP-adressintervallet (100.64.0.0 till 100.127.255.255) eftersom en IP-adress för FHIR-tjänsten allokeras varje gång du gör en åtgärdsbegäran.
Kommentar
Det går att använda en privat IP-adress inom intervallet 10.0.2.0/24, men det finns ingen garanti för att åtgärden lyckas i ett sådant fall. Du kan försöka igen om åtgärdsbegäran misslyckas, men tills du använder en IP-adress inom intervallet 100.64.0.0/10 lyckas inte begäran.
Det här nätverksbeteendet för IP-adressintervall är avsiktligt. Alternativet är att konfigurera lagringskontot i en annan region.
Nästa steg
I den här artikeln har du lärt dig hur du exporterar FHIR-resurser med hjälp av $export kommandot . Mer information om hur du exporterar avidentifierade data finns i
Kommentar
FHIR® är ett registrerat varumärke som tillhör HL7 och används med tillstånd av HL7.