Exportieren von FHIR-Daten in der Azure-API für FHIR
Wichtig
Azure API for FHIR wird am 30. September 2026 eingestellt. Befolgen Sie die 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 der Funktion für Massenexport können Daten vom FHIR-Server gemäß der FHIR-Spezifikation exportiert werden.
Bevor Sie $export verwenden, sollten Sie sicherstellen, dass die Azure-API für FHIR für die Verwendung konfiguriert ist. Informationen zum Konfigurieren von Exporteinstellungen und zum Erstellen eines Azure Storage-Kontos 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 Azure API for 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 in dem Speicherkonto gespeichert, das Sie beim Konfigurieren des Exports angegeben haben. Informationen zum Aufrufen des Befehls $export auf dem FHIR-Server finden Sie in der Dokumentation zur $export-Spezifikation von HL7 FHIR.
Aufträge, die in einem schlechten Zustand stecken bleiben
In manchen Situationen besteht das Potenzial, dass ein Job in einem schlechten Zustand stecken bleibt. Dies kann insbesondere auftreten, wenn die Speicherkontoberechtigungen nicht ordnungsgemäß eingerichtet wurden. Eine Möglichkeit zum Überprüfen des Exports 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, besteht die Möglichkeit, dass der aktuelle Auftrag in einem schlechten Zustand stecken 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 for FHIR unterstützt $export auf 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>>
Beim Export werden Daten in mehreren Dateien exportiert, die jeweils Ressourcen von nur einem Typ 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 die Überprüfung des Exportstatus über die URL, die von der Standortkopfzeile während der Warteschlangendauer zurückgegeben wird, sowie das Abbrechen des eigentlichen Exportauftrags unterstützt.
Exportieren von FHIR-Daten nach ADLS Gen2
Derzeit wird „$export“ für ADLS Gen2-fähige Speicherkonten unterstützt. Hierbei gilt aber die folgende Einschränkung:
- Der Benutzer kann die Vorteile hierarchischer Namespaces nicht nutzen, aber es gibt keine Möglichkeit, den Export in ein bestimmtes Unterverzeichnis innerhalb des Containers abzuzielen. Es kann nur ein bestimmter Container angegeben werden (wobei für jeden Export ein neuer Ordner erstellt wird).
- Nach Abschluss eines Exportvorgangs werden nicht noch einmal Daten in diesen Ordner exportiert, da für die nachfolgenden Exporte in denselben Container dann ein neu erstellter Ordner genutzt wird.
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, die alle optional sind:
| 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 nur das Exportieren von Ressourcen, 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 Parameters „_typeFilter“ ist eine durch Trennzeichen getrennte Liste von FHIR-Abfragen, mit denen die Ergebnisse weiter eingegrenzt werden. |
| _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 diesen 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 zum angegebenen Zeitpunkt 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 "true" Momentaufnahme Ansicht oder, mit anderen Worten, 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 den Verlauf/nicht die neuesten versionsierten Ressourcen 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. Es ist wichtig zu beachten, dass die Verwendung dieses Parameters zu einer Erhöhung des Anforderungseinheitenverbrauchs über die Lebensdauer des Exports führen kann. |
Hinweis
Es gibt ein bekanntes Problem mit dem $export Vorgang, der zu unvollständigen Exporten mit Statuserfolg führen kann. 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 beiden folgenden 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 Speicherort befindet wie oder sich an einem anderen Ort befindet als der der Azure-API für FHIR.
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. Beachten Sie, dass sich das Speicherkonto in ausgewählten Netzwerken befindet und nicht öffentlich zugänglich ist. 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 einen bestimmten IP-Adressbereich im CiDR-Format (Classless Inter-Do Standard 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 $export Befehls exportieren. Informationen zum Exportieren von identifizierten Daten finden Sie als Nächstes unter
FHIR® ist eine eingetragene Marke von HL7 und wird mit Genehmigung von HL7 verwendet.