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 Bulksgewijs exporteren kunnen gegevens worden geëxporteerd van de FHIR-server volgens de FHIR-specificatie.
Voordat u $export gebruikt, 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 opdracht $export 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 over de HL7 FHIR $export specificatie voor meer informatie over het aanroepen van $export opdracht in de FHIR-server.
Taken zijn vastgelopen in een slechte status
In sommige situaties is er een kans dat een taak in een slechte staat blijft hangen. Dit kan vooral gebeuren als de machtigingen voor het opslagaccount niet juist zijn ingesteld. Eén manier om 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 er een mogelijkheid dat de huidige taak in een slechte status blijft hangen. 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>>
Bij export worden gegevens geëxporteerd in meerdere bestanden die elk resources van slechts één type bevatten. 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 ondersteunen we $export voor opslagaccounts met ADLS Gen2, met de volgende beperking:
- De gebruiker kan niet profiteren van hiërarchische naamruimten, maar er is geen manier om te exporteren naar een specifieke submap in de container. We bieden alleen de mogelijkheid om een specifieke container te targeten (waarbij we voor elke export een nieuwe map maken).
- Zodra een export is voltooid, exporteren we nooit meer iets naar die map, omdat volgende exports naar dezelfde container zich in een zojuist gemaakte map bevinden.
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. Bijvoorbeeld: _type=Patiënt retourneert 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 waarmee de resultaten verder worden beperkt |
| _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 opgeschoond, garandeert export echte momentopnameweergave, of, met andere woorden, tijdreizen. |
| includeAssociatedData | Nee | Hiermee kunt u geschiedenis en voorlopig verwijderde resources exporteren. Dit filter werkt niet met de queryparameter '_typeFilter'. Voeg waarde toe als '_history' om geschiedenis/niet-meest recente versiebronnen te exporteren. Voeg waarde toe 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. Het is belangrijk te weten dat het gebruik van deze parameter kan 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 de status geslaagd. Er treedt een probleem op wanneer de vlag is_parallel 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 twee onderstaande 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 locatie bevindt als of zich op een andere locatie bevindt dan die van 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. Houd er rekening mee dat het opslagaccount zich op geselecteerde netwerken bevindt en niet openbaar toegankelijk is. 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 opdracht. Zie voor meer informatie over het exporteren van niet-geïdentificeerde gegevens
FHIR® is een geregistreerd handelsmerk van HL7 en wordt gebruikt met de machtiging HL7.
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor