Migrationsstrategien für den Wechsel von Azure API for 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.
Der Azure Health Data Services-FHIR-Dienst ist die Plattform der nächsten Generation für die Integration von Integritätsdaten. Er bietet verwaltete, unternehmensweite FHIR-, DICOM- und MedTech-Dienste für den vielfältigen Gesundheitsdatenaustausch.
Wenn Sie Ihre FHIR-Daten aus Azure API for FHIR zum FHIR-Dienst von Azure Health Data Services migrieren, kann Ihre Organisation von einer verbesserten Leistung, Skalierbarkeit, Sicherheit und Compliance profitieren. Organisationen können auch auf neue Features und Funktionen zugreifen, die in Azure API for FHIR nicht verfügbar sind.
Die Azure-API für FHIR wird am 30. September 2026 eingestellt, sodass Sie Ihre FHIR-Daten so schnell wie möglich zum Azure Health Data Services-FHIR-Dienst migrieren müssen. Um den Prozess zu vereinfachen, haben wir einige Tools und Tipps erstellt, mit denen Sie Ihre Bereitschaft bewerten, Ihre Daten vorbereiten, Ihre Anwendungen migrieren und auf den neuen Dienst umstellen können.
Empfohlene Vorgehensweise
Führen Sie zum Migrieren Ihrer Daten die folgenden Schritte aus:
- Schritt 1: Bewerten der Bereitschaft
- Schritt 2: Vorbereiten der Migration
- Schritt 3: Migrieren von Daten und Anwendungsworkloads
- Schritt 4: Übernahme von Azure-API für FHIR zu Azure Health Data Services
Schritt 1: Bewerten der Bereitschaft
Vergleichen Sie die Unterschiede zwischen der Azure-API für FHIR und Azure Health Data Services. Überprüfen Sie außerdem Ihre Architektur, und bewerten Sie, ob Änderungen vorgenommen werden müssen.
| Capabilities | Azure API for FHIR | Azure Health Data Services |
|---|---|---|
| Einstellungen | Unterstützt: • Lokale RBAC • SMART on FHIR-Proxy |
Geplante eingestellte Unterstützung: • Lokale RBAC (9/6/23) • SMART on FHIR-Proxy (9/21/26) |
| Datenspeichervolume | Mehr als 4 TB | Aktueller Support ist 4 TB (Öffnen Sie eine Azure-Supportanforderung, wenn Sie mehr als 4 TB benötigen) |
| Dateneingang | In OSS verfügbare Tools | $import-Vorgang |
| Automatische Skalierung | Wird auf Anfrage unterstützt, Gebühren fallen an | Standardmäßig ohne Aufpreis aktiviert |
| Suchparameter | Unterstützter Pakettyp: Batch • Include und revinclude, Iterieren des Modifizierers nicht unterstützt • Sortierung unterstützt durch Vorname, Nachname, Geburtsdatum und klinisches Datum |
Unterstützter Pakettyp: Batch und Transaktion • Auswählbare Suchparameter • Include, revinclude und Iterieren des Modifizierers wird unterstützt • Sortierung wird von Zeichenfolgen- und dateTime-Feldern unterstützt |
| Ereignisse | Nicht unterstützt | Unterstützt |
| Infrastruktur | Unterstützt: • Kundenseitig verwaltete Schlüssel • Unterstützung für AZ und PITR • Regionenübergreifende Notfallwiederherstellung |
Unterstützt: • Datenwiederherstellung • Kundenseitig verwaltete Schlüssel Anstehend: • Unterstützung von Verfügbarkeitszonen |
Zu berücksichtigende Punkte, die sich auf Ihre Architektur auswirken können
Der Synchronisierungs-Agent ist veraltet. Wenn Sie den Synchronisierungs-Agenten zum Herstellen einer Verbindung mit Dataverse verwenden, lesen Sie die Übersicht über das Datenintegrations-Toolkit
Der FHIR-Proxy ist veraltet. Wenn Sie FHIR-Proxy für Ereignisse verwenden, lesen Sie die integrierte Ereignisfunktion. Alternativen können mithilfe des Azure Health Data Services-Toolkits angepasst und erstellt werden.
Der SMART on FHIR-Proxy ist veraltet. Sie müssen die neue SMART on FHIR-Funktion verwenden. Weitere Informationen: SMART on FHIR
Azure Health Data Services-FHIR-Dienst unterstützt keine lokalen RBAC- und benutzerdefinierte Autorität. Die Tokenherausstellerautorität muss der Authentifizierungsendpunkt für den Mandanten sein, in dem der FHIR-Dienst ausgeführt wird.
Der IoT-Connector wird nur mit einer Azure-API für den FHIR-Dienst unterstützt. Der IoT-Connector wird vom MedTech-Dienst erfolgreich ausgeführt. Sie müssen einen MedTech-Dienst und den entsprechenden FHIR-Dienst in einem vorhandenen oder neuen Azure Health Data Services-Arbeitsbereich bereitstellen und Ihre Geräte auf den neuen Azure Events Hubs-Geräte-Event Hub verweisen. Verwenden Sie die vorhandenen IoT-Connector-Geräte- und Zielzuordnungsdateien mit der MedTech-Dienstbereitstellung.
Wenn Sie vorhandene FHIR-Daten des IoT-Connector-Geräts von Ihrem Azure API for FHIR-Dienst zum FHIR-Dienst für Azure Health Data Services migrieren möchten, verwenden Sie die Massenexport- und Importfunktionalität im Migrationstool. Ein weiterer Migrationspfad wäre die Bereitstellung eines neuen MedTech-Diensts und die Wiedergabe der IoT-Gerätenachrichten über den MedTech-Dienst.
Schritt 2: Vorbereiten der Migration
Erstellen Sie zuerst einen Migrationsplan. Wir empfehlen die in der Tabelle beschriebenen Migrationsmuster. Abhängig von der Toleranz Ihrer Organisation für Ausfallzeiten können Sie bestimmte Muster und Tools verwenden, um Ihre Migration zu erleichtern.
| Migrationsmuster | Details | Wie? |
|---|---|---|
| Übertragen und verschieben | Das einfachste Muster. Ideal, wenn längere Ausfallzeiten für Ihre Datenpipelines kein Problem darstellen. | Wählen Sie die Option aus, die den Anforderungen Ihrer Organisation am besten entspricht: • Konfigurieren Sie einen Workflow, um Ihre Daten in der Azure-API für FHIR zu $exportieren, und $importieren Sie sie dann in den FHIR-Dienst für Azure Health Data Services. • Das GitHub-Repository enthält Tipps zum Ausführen dieser Befehle und ein Skript zum Automatisieren der Erstellung der $import-Nutzlast. • Oder erstellen Sie Ihr eigenes Tool zum Migrieren der Daten mithilfe von $export und $import. |
| Inkrementelles Kopieren | Kontinuierliche Version von Lift & Shift mit weniger Ausfallzeiten. Ideal für große Datenmengen, bei denen es länger dauert, sie zu kopieren, oder wenn Sie die Azure-API für FHIR während der Migration weiterhin ausführen möchten. | Wählen Sie eine Option aus, die am besten zu Ihrer Organisation passt. • Wir haben ein OSS-Migrationstool erstellt, um dieses Migrationsmuster zu unterstützen. • Oder erstellen Sie Ihr eigenes Tool zum inkrementellen Migrieren der Daten. |
Überlegungen zum OSS-Migrationstool
Wenn Sie sich für die Verwendung des OSS-Migrationstools entscheiden, überprüfen und verstehen Sie die Funktionen und Einschränkungen des Migrationstools.
Vorbereiten des Azure API für FHIR-Servers
Identifizieren Sie zu migrierende Daten.
Nutzen Sie diese Gelegenheit, um Daten oder FHIR-Server zu bereinigen, die Sie nicht mehr verwenden.
Entscheiden Sie, ob Sie historische Versionen migrieren möchten.
Bereitstellen eines neuen FHIR-Dienstservers in Azure Health Data Services
Stellen Sie zuerst einen Azure Health Data Services-Arbeitsbereich bereit.
Stellen Sie dann einen FHIR-Dienstserver in Azure Health Data Services bereit. Weitere Informationen: Bereitstellen eines FHIR-Diensts in Azure Health Data Services
Konfigurieren eines neuen FHIR-Dienstservers in Azure Health Data Services Wenn Sie die gleichen Konfigurationen wie in der Azure-API für FHIR für Ihren neuen Server verwenden müssen, lesen Sie die empfohlene Liste der zu überprüfenden Informationen in der Dokumentation für Migrationstools. Konfigurieren Sie die Einstellungen vor der Migration.
Schritt 3: Daten migrieren
Wählen Sie das Migrationsmuster aus, das den Anforderungen Ihrer Organisation am besten entspricht. Wenn Sie OSS-Migrationstools verwenden, folgen Sie den Anweisungen auf GitHub.
Schritt 4: Migrieren von Anwendungen und Neukonfiguration von Einstellungen
Migrieren Sie Anwendungen, die auf den alten FHIR-Server verwiesen.
Ändern Sie die Endpunkte Ihrer Anwendungen so, dass sie auf die URL des neuen FHIR-Servers verweisen.
Richten Sie Berechtigungen für diese Apps erneut ein.
Konfigurieren Sie alle verbleibenden Einstellungen im neuen Azure Health Data Services-FHIR-Server nach der Migration neu.
Wenn Sie überprüfen möchten, ob der Azure Health Data Services-FHIR-Dienst und die Azure-API für FHIR-Server über die gleichen Konfigurationen verfügen, können Sie beide Metadatenendpunkte überprüfen, um die beiden Server zu vergleichen und zu unterscheiden.
Einrichten von Aufträgen, die zuvor in Ihrer alten Azure-API für FHIR-Server ausgeführt wurden (z. B. $export-Aufträge)
Schritt 5: Übernahme der Azure Health Data Services-FHIR-Dienste
Nachdem Sie sicher sind, dass Ihr Azure Health Data Services-FHIR-Dienstserver stabil ist, können Sie mit der Verwendung des FHIR-Diensts für Azure Health Data Services für Ihre Geschäftsszenarien beginnen. Deaktivieren Sie alle verbleibenden Pipelines, die auf der Azure-API für FHIR ausgeführt werden, löschen Sie Daten aus dem Zwischenspeicherkonto, das bei Bedarf im Migrationstool verwendet wurde, löschen Sie Daten aus Ihrer Azure-API für FHIR-Server, und deaktivieren Sie Ihre Azure-API für das FHIR-Konto.