FHIR-gegevens exporteren in Azure API for FHIR
Belangrijk
Azure API for FHIR wordt op 30 september 2026 buiten gebruik gesteld. Volg de migratiestrategieën om op die datum over te stappen naar de FHIR-service® van Azure Health Data Services. Vanwege de buitengebruikstelling van Azure API for FHIR zijn nieuwe implementaties vanaf 1 april 2025 niet toegestaan. De FHIR-service van Azure Health Data Services is de ontwikkelde versie van Azure API for FHIR waarmee klanten FHIR-, DICOM- en MedTech-services kunnen beheren met integraties in andere Azure-services.
Met de functie Bulkexport kunnen gegevens worden geëxporteerd van de FHIR-server® volgens de FHIR-specificatie.
Voordat u deze gebruikt $export, moet u ervoor zorgen dat de Azure API for FHIR is geconfigureerd om deze te gebruiken. Raadpleeg de pagina Exportgegevens configureren voor het configureren van exportinstellingen en het maken van een Azure-opslagaccount.
Notitie
Alleen opslagaccounts in hetzelfde abonnement als die voor Azure API for FHIR mogen worden geregistreerd als de bestemming voor $export bewerkingen.
De opdracht $export gebruiken
Nadat u de Azure API for FHIR voor export hebt geconfigureerd, kunt u de $export opdracht gebruiken om de gegevens uit de service te exporteren. De gegevens worden opgeslagen in het opslagaccount dat u hebt opgegeven tijdens het configureren van export. Lees de documentatie in de HL7 FHIR-$export specificatie voor meer informatie over het aanroepen van de $export opdracht in de FHIR-server.
Taken zijn vastgelopen in een slechte status
In sommige situaties kan een taak vastlopen in een slechte status. Dit kan gebeuren als de machtigingen voor het opslagaccount niet juist zijn ingesteld. Een manier om een export te valideren, is door uw opslagaccount te controleren of de bijbehorende container (dat wil ndjsongezegd) bestanden aanwezig zijn. Als ze niet aanwezig zijn en er geen andere exporttaken worden uitgevoerd, is het mogelijk dat de huidige taak is vastgelopen in een slechte status. U moet de exporttaak annuleren door een annuleringsaanvraag te verzenden en de taak opnieuw te verzenden. De standaarduitvoeringstijd voor een export is 10 minuten voordat deze stopt en naar een nieuwe taak gaat of de export opnieuw probeert uit te voeren.
De Azure API For FHIR ondersteunt $export op de volgende niveaus:
- Systeem:
GET https://<<FHIR service base URL>>/$export>> - Patiënt:
GET https://<<FHIR service base URL>>/Patient/$export>> - Groep patiënten* - Azure API for FHIR exporteert alle gerelateerde resources, maar exporteert niet de kenmerken van de groep:
GET https://<<FHIR service base URL>>/Group/[ID]/$export>>
Gegevens worden geëxporteerd in meerdere bestanden, elk met resources van slechts één type. Het aantal resources in een afzonderlijk bestand is beperkt. Het maximum aantal resources is gebaseerd op systeemprestaties. Het is momenteel ingesteld op 5000, maar kan veranderen. Het resultaat is dat u mogelijk meerdere bestanden voor een resourcetype krijgt. De bestandsnamen volgen de indeling 'resourceName-number-number.ndjson'. De volgorde van de bestanden komt niet gegarandeerd overeen met de volgorde van de resources in de database.
Notitie
Patient/$export en Group/[ID]/$export kan dubbele resources exporteren als de resource zich in een compartiment van meer dan één resource bevindt of zich in meerdere groepen bevindt.
Daarnaast wordt het controleren van de exportstatus via de URL die wordt geretourneerd door de locatieheader tijdens de wachtrij ondersteund, samen met het annuleren van de werkelijke exporttaak.
FHIR-gegevens exporteren naar ADLS Gen2
Momenteel wordt ondersteuning $export geboden voor opslagaccounts met ADLS Gen2, met de volgende beperkingen:
- Gebruikers kunnen niet profiteren van hiërarchische naamruimten . Er is geen manier om een export naar een specifieke submap binnen een container te richten. We bieden alleen de mogelijkheid om een specifieke container te targeten (waarbij voor elke export een nieuwe map wordt gemaakt).
- Zodra een export is voltooid, wordt er nooit meer naar die map geëxporteerd. Volgende exports naar dezelfde container bevinden zich in een zojuist gemaakte map.
Instellingen en parameters
Kopteksten
Er zijn twee vereiste headerparameters die moeten worden ingesteld voor $export taken. De waarden worden gedefinieerd door de huidige $export specificatie.
- Accepteren - application/fhir+json
- Voorkeur : reageren-asynchroon
Queryparameters
De Azure API for FHIR ondersteunt de volgende queryparameters. Al deze parameters zijn optioneel.
| Queryparameter | Gedefinieerd door de FHIR-specificatie? | Beschrijving |
|---|---|---|
| _outputFormat | Ja | Ondersteunt momenteel drie waarden die moeten worden uitgelijnd met de FHIR-specificatie: application/fhir+ndjson, application/ndjson of ndjson. Alle exporttaken retourneren ndjson en de doorgegeven waarde heeft geen invloed op het gedrag van code. |
| _sinds | Ja | Hiermee kunt u alleen resources exporteren die zijn gewijzigd sinds de opgegeven tijd. |
| _type | Ja | Hiermee kunt u opgeven welke typen resources worden opgenomen. _type=Patiënt retourneert bijvoorbeeld alleen patiëntbronnen. |
| _typefilter | Ja | Als u fijnmazige filters wilt aanvragen, kunt u _typefilter samen met de parameter _type gebruiken. De waarde van de parameter _typeFilter is een door komma's gescheiden lijst met FHIR-query's die de resultaten verder beperken. |
| _container | Nee | Hiermee geeft u de container in het geconfigureerde opslagaccount op waar de gegevens moeten worden geëxporteerd. Als er een container is opgegeven, worden de gegevens geëxporteerd naar een map in die container. Als de container niet is opgegeven, worden de gegevens geëxporteerd naar een nieuwe container. |
| _tot | Nee | Hiermee kunt u alleen resources exporteren die zijn gewijzigd tot de opgegeven tijd. Deze parameter is alleen van toepassing op export op systeemniveau. In dit geval, als historische versies niet zijn uitgeschakeld of verwijderd, garandeert export een echte momentopnameweergave. Met andere woorden, maakt tijdreizen mogelijk. |
| includeAssociatedData | Nee | Hiermee kunt u geschiedenis en voorlopig verwijderde resources exporteren. Dit filter werkt niet met de queryparameter '_typeFilter'. Neem de waarde op als '_history' om de geschiedenis (niet-meest recente versiebeheerde) resources te exporteren. Neem de waarde op als '_deleted' om voorlopig verwijderde resources te exporteren. |
| _isparallel | Nee | De queryparameter '_isparallel' kan worden toegevoegd aan de exportbewerking om de doorvoer te verbeteren. De waarde moet worden ingesteld op True om parallellisatie in te schakelen. Opmerking: Als u deze parameter gebruikt, kan dit leiden tot een toename van het verbruik van aanvraageenheden gedurende de levensduur van de export. |
Notitie
Er is een bekend probleem met de $export bewerking die kan leiden tot onvolledige exportbewerkingen met een geslaagde status. Het probleem treedt op wanneer de is_parallel vlag is gebruikt. Exporttaken die worden uitgevoerd met _isparallel queryparameter vanaf 13 februari 2024, worden beïnvloed door dit probleem.
Veilige export naar Azure Storage
Azure API for FHIR ondersteunt een veilige exportbewerking. Kies een van de volgende twee opties.
Toestaan dat Azure API for FHIR als een vertrouwde Microsoft-service toegang heeft tot het Azure-opslagaccount.
Specifieke IP-adressen die zijn gekoppeld aan Azure API for FHIR toegang geven tot het Azure-opslagaccount. Deze optie biedt twee verschillende configuraties, afhankelijk van of het opslagaccount zich op dezelfde of een andere locatie bevindt als de Azure API for FHIR.
Azure API for FHIR toestaan als een vertrouwde Microsoft-service
Selecteer een opslagaccount in Azure Portal en selecteer vervolgens de blade Netwerken . Selecteer Geselecteerde netwerken op het tabblad Firewalls en virtuele netwerken.
Belangrijk
Zorg ervoor dat u toegangsmachtigingen hebt verleend voor het opslagaccount voor Azure API for FHIR met behulp van de beheerde identiteit. Zie Exportinstelling configureren en het opslagaccount instellen voor meer informatie.
Selecteer in de sectie Uitzonderingen het selectievakje Vertrouwde Microsoft-services toegang geven tot dit opslagaccount en sla de instelling op.
U kunt nu FHIR-gegevens veilig exporteren naar het opslagaccount. Opmerking: het opslagaccount bevindt zich op geselecteerde netwerken en is niet openbaar toegankelijk. Voor toegang tot de bestanden kunt u privé-eindpunten inschakelen en gebruiken voor het opslagaccount of alle netwerken voor het opslagaccount gedurende een korte periode inschakelen.
Belangrijk
De gebruikersinterface wordt later bijgewerkt, zodat u het resourcetype voor Azure API for FHIR en een specifiek service-exemplaar kunt selecteren.
Specifieke IP-adressen toegang geven tot het Azure-opslagaccount vanuit andere Azure-regio's
Ga in Azure Portal naar het Azure Data Lake Storage Gen2-account.
Selecteer Netwerken in het linkermenu.
Selecteer Ingeschakeld in geselecteerde virtuele netwerken en IP-adressen.
Geef in de sectie Firewall in het vak Adresbereik het IP-adres op. Voeg IP-bereiken toe om toegang vanaf internet of uw on-premises netwerken toe te staan. U vindt het IP-adres in de volgende tabel voor de Azure-regio waar de FHIR-service is ingericht.
Azure-regio Openbaar IP-adres Australië - oost 20.53.44.80 Canada - midden 20.48.192.84 Central US 52.182.208.31 VS - oost 20.62.128.148 VS - oost 2 20.49.102.228 VS - oost 2 EUAP 20.39.26.254 Duitsland - noord 51.116.51.33 Duitsland - west-centraal 51.116.146.216 Japan East 20.191.160.26 Korea - centraal 20.41.69.51 VS - noord-centraal 20.49.114.188 Europa - noord 52.146.131.52 Zuid-Afrika - noord 102.133.220.197 VS - zuid-centraal 13.73.254.220 Azië - zuidoost 23.98.108.42 Zwitserland - noord 51.107.60.95 Verenigd Koninkrijk Zuid 51.104.30.170 Verenigd Koninkrijk West 51.137.164.94 VS - west-centraal 52.150.156.44 Europa -west 20.61.98.66 VS - west 2 40.64.135.77
Specifieke IP-adressen toegang geven tot het Azure-opslagaccount in dezelfde regio
Het configuratieproces voor IP-adressen in dezelfde regio is net als de vorige procedure, behalve dat u in plaats daarvan een specifiek IP-adresbereik gebruikt in CIDR-indeling (Classless Inter-Domain Routing) (dat wil gezegd 100.64.0.0/10). U moet het IP-adresbereik (100.64.0.0 tot 100.127.255.255) opgeven omdat telkens wanneer u een bewerkingsaanvraag indient, een IP-adres voor de FHIR-service wordt toegewezen.
Notitie
Het is mogelijk om een privé-IP-adres te gebruiken binnen het bereik van 10.0.2.0/24, maar er is geen garantie dat de bewerking in een dergelijk geval slaagt. U kunt het opnieuw proberen als de bewerkingsaanvraag mislukt, maar totdat u een IP-adres binnen het bereik van 100.64.0.0.0/10 gebruikt, slaagt de aanvraag niet.
Dit netwerkgedrag voor IP-adresbereiken is standaard. Het alternatief is om het opslagaccount in een andere regio te configureren.
Volgende stappen
In dit artikel hebt u geleerd hoe u FHIR-resources exporteert met behulp van $export de opdracht. Zie voor meer informatie over het exporteren van niet-geïdentificeerde gegevens
Notitie
FHIR® is een geregistreerd handelsmerk van HL7 en wordt gebruikt met de machtiging HL7.