Exportieren von FHIR-Daten in der Azure-API für FHIR
Wichtig
Azure API for FHIR wird am 30. September 2026 eingestellt. Folgen Sie den Migrationsstrategien, um bis zu diesem Datum zum Azure Health Data Services-FHIR®-Dienst zu wechseln. Aufgrund der Einstellung von Azure API for FHIR werden neue Bereitstellungen ab dem 1. April 2025 nicht zugelassen. Der Azure Health Data Services-FHIR-Dienst ist die weiterentwickelte Version der Azure-API für FHIR, mit der Kundschaft FHIR-, DICOM- und Medizintechnikdienste mit Integrationen in andere Azure-Dienste verwalten kann.
Mit dem Feature "Massenexport" können Daten pro FHIR-Spezifikation aus dem FHIR-Server® exportiert werden.
Stellen Sie vor der Verwendung $exportsicher, dass die Azure-API für FHIR für die Verwendung konfiguriert ist. Informationen zum Konfigurieren von Exporteinstellungen und zum Erstellen eines Azure-Speicherkontos finden Sie auf der Seite zum Konfigurieren von Exportdaten.
Hinweis
Nur Speicherkonten im selben Abonnement wie für die Azure-API für FHIR dürfen als Ziel für $export-Vorgänge registriert werden.
Verwenden $export-Befehls
Nachdem Sie die Azure-API für FHIR für den Export konfiguriert haben, können Sie den $export Befehl verwenden, um die Daten aus dem Dienst zu exportieren. Die Daten werden im speicherkonto gespeichert, das Sie beim Konfigurieren des Exports angegeben haben. Wenn Sie erfahren möchten, wie Sie den Befehl auf dem $export FHIR-Server aufrufen, lesen Sie die Dokumentation in der HL7 FHIR-$export Spezifikation.
Aufträge, die in einem schlechten Zustand stecken bleiben
In einigen Situationen kann ein Job in einem schlechten Zustand hängen bleiben. Dies kann auftreten, wenn die Berechtigungen des Speicherkontos nicht ordnungsgemäß eingerichtet wurden. Eine Möglichkeit, einen Export zu überprüfen, besteht darin, ihr Speicherkonto zu überprüfen, um festzustellen, ndjsonob der entsprechende Container (d. h. die ) Dateien vorhanden sind. Wenn sie nicht vorhanden sind und keine anderen Exportaufträge ausgeführt werden, ist es möglich, dass der aktuelle Auftrag in einem schlechten Zustand hängen bleibt. Sie sollten den Exportauftrag abbrechen, indem Sie eine Abbruchanforderung senden und versuchen, den Auftrag erneut aufzufordern. Die Standardlaufzeit für einen Export in ungültigem Zustand beträgt 10 Minuten, bevor er beendet wird und zu einem neuen Auftrag wechselt oder den Export wiederholen wird.
Die Azure-API für FHIR unterstützt $export auf den folgenden Ebenen:
- System:
GET https://<<FHIR service base URL>>/$export>> - Patient:
GET https://<<FHIR service base URL>>/Patient/$export>> - Patientengruppe* – Azure-API für FHIR exportiert alle zugehörigen Ressourcen, exportiert aber nicht die Merkmale der Gruppe:
GET https://<<FHIR service base URL>>/Group/[ID]/$export>>
Daten werden in mehrere Dateien exportiert, die jeweils nur Ressourcen eines Typs enthalten. Die Anzahl der Ressourcen in einer einzelnen Datei ist begrenzt. Die maximale Anzahl von Ressourcen basiert auf der Systemleistung. Es ist derzeit auf 5.000 festgelegt, kann sich aber ändern. Das Ergebnis ist, dass Sie möglicherweise mehrere Dateien für einen Ressourcentyp abrufen. Die Dateinamen folgen dem Format "resourceName-number-number.ndjson". Die Reihenfolge der Dateien ist nicht garantiert, dass sie einer Sortierung der Ressourcen in der Datenbank entspricht.
Hinweis
Patient/$export und Group/[ID]/$export exportieren möglicherweise doppelt vorhandene Ressourcen, wenn sich die Ressource in einem Depot mehrerer Ressourcen befindet oder in mehreren Gruppen vorhanden ist.
Darüber hinaus wird das Überprüfen des Exportstatus über die URL, die vom Positionsheader während der Warteschlange zurückgegeben wird, unterstützt, zusammen mit dem Abbrechen des tatsächlichen Exportauftrags.
Exportieren von FHIR-Daten nach ADLS Gen2
Derzeit unterstützen $export wir ADLS Gen2-aktivierte Speicherkonten mit den folgenden Einschränkungen:
- Benutzer können hierarchische Namespaces nicht nutzen – es gibt keine Möglichkeit, einen Export in ein bestimmtes Unterverzeichnis innerhalb eines Containers zu richten. Wir bieten nur die Möglichkeit, auf einen bestimmten Container zu abzielen (wobei für jeden Export ein neuer Ordner erstellt wird).
- Sobald ein Export abgeschlossen ist, wird nie wieder in diesen Ordner exportiert. Nachfolgende Exporte in denselben Container befinden sich in einem neu erstellten Ordner.
Einstellungen und Parameter
Headers
Es gibt zwei erforderliche Headerparameter, die für $export Aufträge festgelegt werden müssen. Die Werte werden durch die aktuelle $export-Spezifikation definiert.
- Accept: application/fhir+json
- Prefer: respond-async
Abfrageparameter
Die Azure API for FHIR unterstützt die folgenden Abfrageparameter, Alle diese Parameter sind optional.
| Query parameter (Abfrageparameter) | Definiert durch die FHIR-Spezifikation? | Beschreibung |
|---|---|---|
| _outputFormat | Ja | Unterstützt derzeit drei Werte für die Ausrichtung an der FHIR-Spezifikation: application/fhir+ndjson, application/ndjson oder ndjson. Alle Exportaufträge werden zurückgegeben ndjson , und der übergebene Wert hat keine Auswirkungen auf das Codeverhalten. |
| _seit | Ja | Ermöglicht es Ihnen, nur Ressourcen zu exportieren, die seit dem angegebenen Zeitpunkt geändert wurden. |
| _type | Ja | Ermöglicht die Angabe, welche Ressourcentypen eingeschlossen werden sollen. Beispielsweise würde _type=Patient nur Patientenressourcen zurückgeben. |
| _typefilter | Ja | Um eine feiner abgestimmte Filterung anzufordern, können Sie _typefilter zusammen mit dem parameter _type verwenden. Der Wert des _typeFilter-Parameters ist eine durch Trennzeichen getrennte Liste von FHIR-Abfragen, die die Ergebnisse weiter einschränken. |
| _Container | No | Gibt den Container innerhalb des konfigurierten Speicherkontos an, in den die Daten exportiert werden sollen. Wenn ein Container angegeben ist, werden die Daten in einen Ordner in diesem Container exportiert. Wenn der Container nicht angegeben ist, werden die Daten in einen neuen Container exportiert. |
| _bis | No | Ermöglicht es Ihnen, nur Ressourcen zu exportieren, die bis zur angegebenen Zeit geändert wurden. Dieser Parameter gilt nur für den Export auf Systemebene. Wenn historische Versionen in diesem Fall nicht deaktiviert oder gelöscht wurden, garantiert der Export eine echte Momentaufnahmeansicht. Mit anderen Worten, ermöglicht Zeitreisen. |
| includeAssociatedData | No | Ermöglicht ihnen das Exportieren des Verlaufs und vorläufig gelöschter Ressourcen. Dieser Filter funktioniert nicht mit dem Abfrageparameter "_typeFilter". Schließen Sie den Wert als "_history" ein, um die Verlaufsressourcen (nicht neueste Versionsversion) zu exportieren. Schließen Sie den Wert als "_deleted" ein, um vorläufig gelöschte Ressourcen zu exportieren. |
| _isparallel | No | Der Abfrageparameter "_isparallel" kann dem Exportvorgang hinzugefügt werden, um den Durchsatz zu verbessern. Der Wert muss auf "true" festgelegt werden, um die Parallelisierung zu aktivieren. Hinweis: Die Verwendung dieses Parameters kann zu einer Erhöhung des Anforderungseinheitenverbrauchs über die Lebensdauer des Exports führen. |
Hinweis
Es gibt ein bekanntes Problem mit dem $export Vorgang, das zu unvollständigen Exporten mit Statuserfolg führen kann. Das Problem tritt auf, wenn das is_parallel-Flag verwendet wurde. Exportaufträge, die mit _isparallel Abfrageparameter ab dem 13. Februar 2024 ausgeführt werden, sind mit diesem Problem betroffen.
Sicherer Export in Azure Storage
Für Azure API for FHIR wird ein sicherer Exportvorgang unterstützt. Wählen Sie eine der folgenden beiden Optionen aus.
Zulassen der Azure-API für FHIR als vertrauenswürdiger Microsoft-Dienst für den Zugriff auf das Azure-Speicherkonto.
Zulassen bestimmter IP-Adressen, die mit der Azure-API für FHIR verknüpft sind, für den Zugriff auf das Azure-Speicherkonto. Diese Option bietet zwei unterschiedliche Konfigurationen, je nachdem, ob sich das Speicherkonto am gleichen oder anderen Speicherort wie die Azure-API für FHIR befindet.
Zulassen der Azure-API für FHIR als vertrauenswürdiger Microsoft-Dienst
Wählen Sie ein Speicherkonto aus dem Azure-Portal aus, und wählen Sie dann das Blatt "Netzwerk" aus. Wählen Sie ausgewählte Netzwerke unter der Registerkarte "Firewalls" und "Virtuelle Netzwerke " aus.
Wichtig
Stellen Sie sicher, dass Sie über die verwaltete Identität die Zugriffsberechtigung für das Speicherkonto für die Azure-API für FHIR erteilt haben. Weitere Informationen finden Sie unter Konfigurieren der Exporteinstellung und Einrichten des Speicherkontos.
Wählen Sie im Abschnitt "Ausnahmen" das Kontrollkästchen "Vertrauenswürdige Microsoft-Dienste zulassen" aus, um auf dieses Speicherkonto zuzugreifen und die Einstellung zu speichern.
Jetzt können Sie FHIR-Daten sicher in das Speicherkonto exportieren. Hinweis: Das Speicherkonto befindet sich in ausgewählten Netzwerken und ist nicht öffentlich zugänglich. Um auf die Dateien zuzugreifen, können Sie entweder private Endpunkte für das Speicherkonto aktivieren und verwenden oder alle Netzwerke für das Speicherkonto für einen kurzen Zeitraum aktivieren.
Wichtig
Die Benutzeroberfläche wird später aktualisiert, damit Sie den Ressourcentyp für die Azure-API für FHIR und eine bestimmte Dienstinstanz auswählen können.
Zulassen bestimmter IP-Adressen für den Zugriff auf das Azure-Speicherkonto aus anderen Azure-Regionen
Wechseln Sie im Azure-Portal zum Azure Data Lake Storage Gen2-Konto.
Wählen Sie im linken Menü Netzwerk aus.
Wählen Sie Aktiviert von ausgewählten virtuellen Netzwerken und IP-Adressen aus.
Geben Sie im Abschnitt "Firewall" im Feld "Adressbereich" die IP-Adresse an. Hiermit werden IP-Adressbereiche hinzugefügt, um Zugriff vom Internet oder von Ihren lokalen Netzwerken aus zu gewähren. Die IP-Adresse finden Sie in der folgenden Tabelle für die Azure-Region, in der der FHIR-Dienst bereitgestellt wird.
Azure-Region Öffentliche IP-Adresse Australien (Osten) 20.53.44.80 Kanada, Mitte 20.48.192.84 USA (Mitte) 52.182.208.31 East US 20.62.128.148 USA (Ost) 2 20.49.102.228 USA, Osten 2 (EUAP) 20.39.26.254 Deutschland, Norden 51.116.51.33 Deutschland, Westen-Mitte 51.116.146.216 Japan, Osten 20.191.160.26 Korea, Mitte 20.41.69.51 USA Nord Mitte 20.49.114.188 Nordeuropa 52.146.131.52 Südafrika, Norden 102.133.220.197 USA Süd Mitte 13.73.254.220 Asien, Südosten 23.98.108.42 Schweiz, Norden 51.107.60.95 UK, Süden 51.104.30.170 UK, Westen 51.137.164.94 USA, Westen-Mitte 52.150.156.44 Europa, Westen 20.61.98.66 USA, Westen 2 40.64.135.77
Zulassen bestimmter IP-Adressen für den Zugriff auf das Azure-Speicherkonto in derselben Region
Der Konfigurationsprozess für IP-Adressen in derselben Region entspricht dem vorherigen Verfahren, mit der Ausnahme, dass Sie stattdessen einen bestimmten IP-Adressbereich im CIDR-Format (Classless Inter-Domain Routing) verwenden (d. h. 100.64.0.0/10). Sie müssen den IP-Adressbereich (100.64.0.0 bis 100.127.255.255) angeben, da bei jeder Vorgangsanforderung eine IP-Adresse für den FHIR-Dienst zugewiesen wird.
Hinweis
Es ist möglich, eine private IP-Adresse im Bereich von 10.0.2.0/24 zu verwenden, aber es gibt keine Garantie, dass der Vorgang in einem solchen Fall erfolgreich ist. Sie können versuchen, wenn die Vorgangsanforderung fehlschlägt, aber bis Sie eine IP-Adresse innerhalb des Bereichs von 100.64.0.0/10 verwenden, wird die Anforderung nicht erfolgreich ausgeführt.
Dieses Netzwerkverhalten für IP-Adressbereiche ist beabsichtigt. Die Alternative besteht darin, das Speicherkonto in einer anderen Region zu konfigurieren.
Nächste Schritte
In diesem Artikel haben Sie erfahren, wie Sie FHIR-Ressourcen mithilfe des $export Befehls exportieren. Informationen zum Exportieren von identifizierten Daten finden Sie als Nächstes unter
Hinweis
FHIR® ist eine eingetragene Marke von HL7 und wird mit Genehmigung von HL7 verwendet.