Migrationsstrategien für den Wechsel von der Azure-API für FHIR

Wichtig

Die Azure-API für 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 der Azure-API für 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 Kunden FHIR-, DICOM- und MedTech-Dienste mit Integrationen in andere Azure-Dienste verwalten können.

Der Azure Health Data Services-FHIR-Dienst ist die Plattform der nächsten Generation für die Integration von Integritätsdaten. Es bietet verwaltete, unternehmensweite FHIR-, DICOM- und MedTech-Dienste für den vielfältigen Gesundheitsdatenaustausch.

Wenn Sie Ihre FHIR-Daten aus der Azure-API für FHIR zu azure Health Data Services FHIR-Dienst 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 der Azure-API für 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 zu 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.

Führen Sie die folgenden Schritte aus, um Ihre Daten zu migrieren:

  • 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 auf FHIR-Proxy
Geplante Deaktivierung:
• LokaleS RBAC (9/6/23)
• SMART auf FHIR Proxy (9/21/26)
Datenspeichervolume Mehr als 4 TB Aktueller Support ist 4 TB (Öffnen Sie eine Azure-Support Anforderung, wenn Sie mehr als 4 TB benötigen)
Dateneingang In OSS verfügbare Tools $import-Vorgang
Automatische Skalierung Wird auf Anfrage unterstützt und anfallen Gebühren Standardmäßig ohne Aufpreis aktiviert
Suchparameter Pakettyp unterstützt: Batch
• Einschließen und Neuzurücken, Iterieren des Modifizierers nicht unterstützt
• Sortierung unterstützt durch Vorname, Nachname, Geburtsdatum und klinisches Datum
Pakettyp unterstützt: Batch und Transaktion
• Auswählbare Suchparameter
• Include, revinclude, and iterate modifier is supported
• Sortierung unterstützt durch Zeichenfolgen- und DateTime-Felder
Ereignisse Nicht unterstützt Unterstützt
Infrastruktur Unterstützt:
• Vom Kunden verwaltete Schlüssel
• AZ-Unterstützung und PITR
• Regionenübergreifendes DR
Unterstützt:
• Datenwiederherstellung
Vom Kunden verwaltete Schlüssel
Bevorstehende:
• Verfügbarkeitszonenunterstützung

Zu berücksichtigende Punkte, die sich auf Ihre Architektur auswirken können

  • Der Synchronisierungs-Agent ist veraltet. Wenn Sie den Synchronisierungs-Agent 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.

  • SMART auf FHIR-Proxy ist veraltet. Sie müssen die neue SMART on FHIR-Funktion verwenden. Weitere Informationen: SMART auf FHIR

  • Der Azure Health Data Services-FHIR-Dienst unterstützt keine lokale RBAC und benutzerdefinierte Autorität. Die Tokenherausgeberautoritä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äteereignishub verweisen. Verwenden Sie die vorhandenen IoT-Connectorgeräte- und Zielzuordnungsdateien mit der MedTech-Dienstbereitstellung.

Wenn Sie vorhandene FHIR-Daten des IoT-Connectors von Ihrer Azure-API für 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 zunächst 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 Ihre Datenpipeline längere Ausfallzeiten leisten kann. Wählen Sie die Option aus, die für Ihre Organisation am besten geeignet ist:
• Konfigurieren sie einen Workflow, um Ihre Daten in der Azure-API für FHIR zu $export und dann in den FHIR-Dienst für Azure Health Data Services zu $import.
• Das GitHub-Repository enthält Tipps zum Ausführen dieser Befehle und ein Skript zum Automatisieren des Erstellens der $import Nutzlast.
• Oder erstellen Sie Ihr eigenes Tool, um die Daten mithilfe von $export und $import zu migrieren.
Inkrementelles Kopieren Kontinuierliche Version von Lift und Schicht, mit weniger Ausfallzeiten. Ideal für große Datenmengen, die länger zum Kopieren dauern, 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 diesem Migrationsmuster zu helfen.
• Oder erstellen Sie Ihr eigenes Tool, um die Daten inkrementell zu migrieren.

Ü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 der Azure-API für den FHIR-Server

Identifizieren Sie zu migrierende Daten.

  • Nutzen Sie diese Gelegenheit, um Daten oder FHIR-Server zu sauber, die Sie nicht mehr verwenden.

  • Entscheiden Sie, ob Sie historische Versionen migrieren möchten oder nicht.

Stellen Sie einen neuen FHIR-Dienstserver für Azure Health Data Services bereit.

  • Stellen Sie zunächst einen Azure Health Data Services-Arbeitsbereich bereit.

  • Stellen Sie dann einen FHIR-Dienstserver für Azure Health Data Services bereit. Weitere Informationen: Bereitstellen eines FHIR-Diensts in Azure Health Data Services

  • Konfigurieren Sie Ihren neuen Azure Health Data Services-FHIR-Dienstserver. Wenn Sie die gleichen Konfigurationen wie in der Azure-API für FHIR für Ihren neuen Server verwenden müssen, finden Sie in der empfohlenen Liste der Informationen in der Dokumentation zum Migrationstool. Konfigurieren Sie die Einstellungen vor der Migration.

Schritt 3: Migrieren von Daten

Wählen Sie das Migrationsmuster aus, das für Ihre Organisation am besten geeignet ist. 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 verweisen.

  • Ä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 Neukonfigurationseinstellungen im neuen Azure Health Data Services-FHIR-Dienstserver nach der Migration neu Standard.

  • 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 vergleichen.

  • 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 von Azure Health Data Services-FHIR-Diensten

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 beginnen, um Ihre Geschäftsszenarien zu erfüllen. Deaktivieren Sie alle erneuten Pipelines Standard, 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.