Migreringsstrategier för att flytta från Azure API för FHIR

Viktigt

Azure API för FHIR avvecklas den 30 september 2026. Följ migreringsstrategierna för att övergå till Azure Health Data Services FHIR-tjänsten® senast det datumet. På grund av att Azure API för FHIR dras tillbaka tillåts inte nya kunddistributioner från och med den 1 april 2025. Azure Health Data Services FHIR-tjänsten är den utvecklade versionen av Azure API för FHIR som gör det möjligt för kunder att hantera FHIR - och DICOM-tjänster med integreringar i andra Azure-tjänster.

Azure Health Data Services FHIR-tjänsten® är nästa generations plattform för integrering av hälsodata. Det erbjuder hanterade FHIR- och DICOM-tjänster i företagsklass för olika hälsodatautbyte.

När du migrerar dina FHIR-data från Azure API för FHIR till Azure Health Data Services FHIR-tjänsten kan din organisation dra nytta av bättre prestanda, skalbarhet, säkerhet och efterlevnad. Organisationer kan också komma åt nya funktioner som inte är tillgängliga i Azure API för FHIR.

Azure API för FHIR dras tillbaka den 30 september 2026, så du måste migrera dina FHIR-data till Azure Health Data Services FHIR-tjänsten så snart som möjligt. För att göra processen enklare skapade vi några verktyg och tips som hjälper dig att utvärdera din beredskap, förbereda dina data, migrera dina program och skära över till den nya tjänsten.

Rekommenderat tillvägagångssätt

Följ dessa steg för att migrera dina data.

• Steg 1: Utvärdera beredskap
• Steg 2: Förbered migreringen
• Steg 3: Migrera data och programarbetsbelastningar
• Steg 4: Klipp över från Azure API för FHIR till Azure Health Data Services

Steg 1: Utvärdera beredskap

Jämför skillnaderna mellan Azure API för FHIR och Azure Health Data Services. Granska även din arkitektur och utvärdera om några ändringar behöver göras.

Förmågor	Azure API for FHIR	Azure Health Data Services
Settings	Inaktuell i samband med att tjänsten tas ur bruk (30/9/26): • Lokal RBAC • SMART på FHIR-proxy	Planerad utfasning: • SMART på FHIR Proxy (9/21/26)
Datalagringsvolym	Mer än 4 TB	Det aktuella stödet är 4 TB. Öppna en Azure-supportbegäran om du behöver mer än 4 TB
Datainflöde	Verktyg som är tillgängliga i OSS	$import åtgärd
Autoscaling	Stöds vid begäran och debiteras	Aktiverad som standard utan extra kostnad
Sökparametrar	Pakettyp som stöds: Batch • Inkludera och återkalla, iterera modifierare som inte stöds • Sortering som stöds efter förnamn, familjenamn, födelsedatum och kliniskt datum	Pakettyp som stöds: Batch och transaktion • Valbara sökparametrar • Inkludera, omvinkla och iterera modifierare stöds • Sortering som stöds av sträng- och dateTime-fält
Events	Stöds inte	Stöds
Infrastructure	Stöds: • Kundhanterade nycklar • Katastrofåterställning över regioner	Stöds: • PITR (återställning till tidpunkt) • Kundhanterade nycklar • Stöd för tillgänglighetszoner

Viktigt

Om din Azure API for FHIR-instans innehåller mer än 2 TB data ska du skicka in en Azure-supportbegäraninnan du påbörjar migreringen. I supportärendet inkluderar du ditt Azure API för FHIR-instansnamn och ditt Azure Health Data Services FHIR-tjänstinstansnamn så att teamet kan hjälpa till med migreringsplaneringen.

Saker att tänka på som kan påverka din arkitektur

• Synkroniseringsagenten håller på att fasas ut. Om du använder synkroniseringsagenten för att ansluta till Dataverse kan du läsa Översikt över verktyg för dataintegrering

• FHIR-proxyn är inaktuell. Om du använder FHIR-proxy för händelser läser du den inbyggda händelsefunktionen . Alternativ kan anpassas och skapas med hjälp av Azure Health Data Services-verktygslådan.

• SMART on FHIR-proxyn fasas ut. Du måste använda den nya funktionen SMART på FHIR. Mer information: SMART på FHIR

• Azure Health Data Services FHIR-tjänsten stöder inte lokal RBAC och anpassad auktoritet. Utfärdare av token måste vara autentiseringsslutpunkten för klientorganisationen som FHIR-tjänsten körs i.

• IoT-anslutningsappen stöds endast med hjälp av ett Azure API för FHIR-tjänsten. Om du vill migrera befintliga FHIR-data för IoT-anslutningsenheter från azure-API:et för FHIR-tjänsten till Azure Health Data Services FHIR-tjänsten använder du massexport- och importfunktionerna i migreringsverktyget.

Steg 2: Förbered migreringen

Skapa först en migreringsplan. Vi rekommenderar de migreringsmönster som beskrivs i följande tabell. Beroende på organisationens tolerans för stilleståndstid kan du välja att använda vissa mönster och verktyg för att underlätta migreringen.

Migreringsmönster	Detaljer	How?
Lyfta och flytta	Det enklaste mönstret. Perfekt om din datapipeline har råd med längre stilleståndstid.	Välj det alternativ som passar bäst för din organisation: • Konfigurera ett arbetsflöde för att $export dina data i Azure API för FHIR och sedan $import till Azure Health Data Services FHIR-tjänst. • GitHub-lagringsplatsen innehåller tips om hur du kör dessa kommandon och ett skript för att automatisera skapandet av $import nyttolasten. • Skapa ett eget verktyg för att migrera data med hjälp av $export och $import.
Inkrementell kopiering	Kontinuerlig version av lift and shift, med mindre stilleståndstid. Perfekt för stora mängder data som tar längre tid att kopiera, eller om du vill fortsätta köra Azure API för FHIR under migreringen.	Välj det alternativ som passar bäst för din organisation. • Vi har skapat ett OSS-migreringsverktyg som hjälper dig med det här migreringsmönstret. • Skapa ett eget verktyg för att migrera data stegvis.

Överväganden för OSS-migreringsverktyg

Om du bestämmer dig för att använda OSS-migreringsverktyget kan du granska och förstå migreringsverktygets funktioner och begränsningar.

Förbereda Azure API för FHIR-server

Identifiera data som ska migreras.

• Ta tillfället i akt att rensa data eller FHIR-servrar som du inte längre använder.

• Bestäm om du vill migrera historiska versioner eller inte.

Distribuera en ny Azure Health Data Services FHIR-tjänstserver.

• Distribuera först en Azure Health Data Services-arbetsyta.

• Distribuera sedan en FHIR-tjänstserver för Azure Health Data Services. Mer information finns här: Distribuera en FHIR-tjänst i Azure Health Data Services.

• Konfigurera din nya Azure Health Data Services FHIR Service-server. Om du behöver använda samma konfigurationer som du har i Azure API för FHIR för din nya server kan du läsa den rekommenderade listan över vad du bör söka efter i dokumentationen för migreringsverktyget. Konfigurera inställningarna innan du migrerar.

Steg 3: Migrera data

Välj det migreringsmönster som fungerar bäst för din organisation. Om du använder OSS-migreringsverktyg följer du anvisningarna på GitHub.

Steg 4: Migrera program och konfigurera om inställningar

Migrera program som pekar på den gamla FHIR-servern.

• Ändra slutpunkterna för dina program så att de pekar på den nya FHIR-serverns URL.

• Konfigurera behörigheter igen för dessa appar.

• Efter migreringen konfigurerar du om eventuella återstående inställningar i den nya Azure Health Data Services FHIR-tjänstservern.

• Om du vill dubbelkolla att Azure Health Data Services FHIR-tjänsten och Azure API för FHIR-servrar har samma konfigurationer kan du kontrollera båda metadataslutpunkterna för att jämföra de två servrarna.

• Konfigurera alla jobb som tidigare kördes i ditt gamla Azure API för FHIR-server (till exempel $export jobb)

Steg 5: Klipp över till Azure Health Data Services FHIR-tjänster

När du är säker på att din Azure Health Data Services FHIR Service-server är stabil kan du börja använda Azure Health Data Services FHIR-tjänsten för att uppfylla dina affärsscenarier. Inaktivera eventuella återstående pipelines som körs i Azure API för FHIR. Ta vid behov bort data från det mellanliggande lagringskonto som användes i migreringsverktyget. Ta bort data från azure-API:et för FHIR-servern och inaktivera ditt Azure API för FHIR-kontot.

Note

FHIR® är ett registrerat varumärke som tillhör HL7 och används med tillstånd av HL7.