Strategie migrace pro přechod z rozhraní Azure API for FHIR

Důležité

Rozhraní Azure API for FHIR bude vyřazeno 30. září 2026. Postupujte podle strategií migrace a do tohoto data přejděte na službu FHIR® služby Azure Health Data Services. Vzhledem k vyřazení rozhraní Azure API for FHIR nebudou nová nasazení od 1. dubna 2025 povolena. Služba FHIR služby Azure Health Data Services je vyvinutá verze rozhraní Azure API for FHIR, která zákazníkům umožňuje spravovat služby FHIR, DICOM a MedTech s integrací do jiných služeb Azure.

Služba FHIR® služby Azure Health Data Services je nová generace platformy pro integraci dat o stavu. Nabízí spravované služby FHIR, DICOM a MedTech na podnikové úrovni pro různorodou výměnu zdravotních dat.

Při migraci dat FHIR z rozhraní Azure API for FHIR do služby FHIR služby Azure Health Data Services může vaše organizace těžit z lepšího výkonu, škálovatelnosti, zabezpečení a dodržování předpisů. Organizace také získají přístup k novým funkcím a možnostem, které nejsou dostupné v rozhraní Azure API for FHIR.

Rozhraní Azure API for FHIR bude vyřazeno 30. září 2026, takže je potřeba migrovat data FHIR do služby FHIR služby Azure Health Data Services, jakmile to bude možné. Abychom tento proces usnadnili, vytvořili jsme několik nástrojů a tipů, které vám pomůžou vyhodnotit připravenost, připravit data, migrovat aplikace a proříznout do nové služby.

Doporučený přístup

Pokud chcete migrovat data, postupujte podle těchto kroků.

• Krok 1: Posouzení připravenosti
• Krok 2: Příprava na migraci
• Krok 3: Migrace úloh dat a aplikací
• Krok 4: Vyjmutí z rozhraní Azure API for FHIR do služby Azure Health Data Services

Krok 1: Posouzení připravenosti

Porovnejte rozdíly mezi rozhraním Azure API for FHIR a datovými službami Azure Health. Zkontrolujte také vaši architekturu a vyhodnoťte, jestli je potřeba provést nějaké změny.

Možnosti	Rozhraní API platformy Azure pro FHIR	Azure Health Data Services
Možnosti	Podporovaný: • Místní řízení přístupu na základě role • SMART na FHIR Proxy	Plánované vyřazení: • Místní RBAC (9/6/23) • SMART on FHIR Proxy (9/21/26)
Svazek úložiště dat	Více než 4 TB	Aktuální podpora je 4 TB. Pokud potřebujete více než 4 TB, otevřete žádost o podpora Azure.
Příchozí přenos dat	Nástroje dostupné v OSS	$import operace
Automatické škálování	Podporováno na vyžádání a účtují se poplatky	Povolené ve výchozím nastavení bez dalších poplatků
Parametry hledání	Podporovaný typ sady: Batch • Zahrnout a revinclude, iterovat modifikátor není podporován • Řazení podporované podle jména, jména rodiny, data narození a klinického data	Podporovaný typ sady: Batch a transakce • Vybratelné parametry hledání • Podporuje se zahrnutí, revinclude a modifikátor iterace. • Řazení podporované podle polí string a dateTime
Události	Nepodporuje se	Podporováno
Infrastruktura	Podporovaný: • Klíče spravované zákazníkem • Zotavení po havárii mezi oblastmi (zotavení po havárii)	Podporovaný: • obnovení k určitému bodu v čase) • Klíče spravované zákazníkem Nastávající: • Podpora zóny dostupnosti

Jaké faktory můžou mít vliv na vaši architekturu

• Agent synchronizace je vyřazován z provozu. Pokud k připojení k Dataverse používáte synchronizačního agenta, přečtěte si téma Přehled sady nástrojů pro integraci dat

• Proxy server FHIR je vyřazován z provozu. Pokud pro události používáte proxy server FHIR, projděte si integrovanou funkci událostí. Alternativy je možné přizpůsobit a sestavit pomocí sady nástrojů Azure Health Data Services.

• Proxy server SMART on FHIR je vyřazován z provozu. Musíte použít novou funkci SMART on FHIR. Další informace: SMART on FHIR

• Služba FHIR služby Azure Health Data Services nepodporuje místní řízení přístupu na základě role a vlastní autoritu. Autorita vystavitele tokenu musí být ověřovacím koncovým bodem tenanta, ve kterém je spuštěná služba FHIR.

• Konektor IoT se podporuje jenom pomocí služby Azure API for FHIR. Konektor IoT je nahrazen službou MedTech. Potřebujete nasadit službu MedTech a odpovídající službu FHIR v existujícím nebo novém pracovním prostoru služby Azure Health Data Services a nasměrovat zařízení na nové centrum událostí zařízení Azure Events Hubs. Použijte existující zařízení konektoru IoT a soubory mapování cílů s nasazením služby MedTech.

Pokud chcete migrovat stávající data FHIR zařízení konektoru IoT z vašeho rozhraní Azure API for FHIR do služby Azure Health Data Services FHIR, použijte funkci hromadného exportu a importu v nástroji pro migraci. Další cestou migrace by bylo nasazení nové služby MedTech a přehrání zpráv zařízení IoT prostřednictvím služby MedTech.

Krok 2: Příprava na migraci

Nejprve vytvořte plán migrace. Doporučujeme vzory migrace popsané v následující tabulce. V závislosti na toleranci vaší organizace pro výpadky se můžete rozhodnout použít určité vzory a nástroje, které vám pomůžou usnadnit migraci.

Model migrace	Detaily	Jak?
Lift and shift	Nejjednodušší vzor. Ideální, pokud si datový kanál může dovolit delší výpadek.	Zvolte možnost, která nejlépe vyhovuje vaší organizaci: • Nakonfigurujte pracovní postup pro $export vašich dat ve službě Azure API for FHIR a pak $import do služby FHIR služby Azure Health Data Services. • Úložiště GitHub obsahuje tipy ke spuštění těchto příkazů a skript, který vám pomůže automatizovat vytváření $import datové části. • Vytvořte vlastní nástroj pro migraci dat pomocí $export a $import.
Přírůstková kopie	Nepřetržitá verze metody lift and shift s menším výpadkem. Ideální pro velké objemy dat, která během migrace trvají déle, nebo pokud chcete během migrace pokračovat ve spouštění rozhraní Azure API for FHIR.	Zvolte si možnost, která vaší organizaci nejlépe vyhovuje. • Vytvořili jsme nástroj pro migraci operačního systému, který vám pomůže s tímto modelem migrace. • Vytvořte vlastní nástroj pro přírůstkovou migraci dat.

Důležité informace o nástroji pro migraci operačního systému

Pokud se rozhodnete použít nástroj pro migraci operačního systému, projděte si a seznamte se s možnostmi a omezeními nástroje pro migraci.

Příprava rozhraní Azure API pro server FHIR

Identifikujte data, která se mají migrovat.

• Využijte tuto příležitost k vyčištění dat nebo serverů FHIR, které už nepoužíváte.

• Rozhodněte se, jestli chcete migrovat historické verze nebo ne.

Nasaďte nový server služby FHIR služby Azure Health Data Services.

• Nejprve nasaďte pracovní prostor služby Azure Health Data Services.

• Pak nasaďte server služby FHIR služby Azure Health Data Services. Další informace najdete tady: Nasazení služby FHIR v rámci služby Azure Health Data Services.

• Nakonfigurujte nový server služby FHIR služby Azure Health Data Services. Pokud potřebujete použít stejné konfigurace jako v rozhraní Azure API for FHIR pro nový server, projděte si doporučený seznam toho, co zkontrolovat v dokumentaci k nástroji pro migraci. Před migrací nakonfigurujte nastavení.

Krok 3: Migrace dat

Zvolte model migrace, který nejlépe vyhovuje vaší organizaci. Pokud používáte nástroje pro migraci operačního systému, postupujte podle pokynů na GitHubu.

Krok 4: Migrace aplikací a změna konfigurace nastavení

Migrujte aplikace, které odkazovaly na starý server FHIR.

• Změňte koncové body vašich aplikací tak, aby odkazovali na adresu URL nového serveru FHIR.

• Znovu nastavte oprávnění pro tyto aplikace.

• Po migraci překonfigurujte všechna zbývající nastavení na novém serveru služby FHIR služby Azure Health Data Services.

• Pokud chcete pečlivě zkontrolovat, že služba Azure Health Data Services FHIR a servery Azure API for FHIR mají stejné konfigurace, můžete zkontrolovat oba koncové body metadat a porovnat oba servery.

• Nastavte všechny úlohy, které byly dříve spuštěné na starém serveru Azure API for FHIR (například $export úlohy).

Krok 5: Vyjmutí služeb FHIR ve službě Azure Health Data Services

Jakmile budete mít jistotu, že je váš server služby FHIR služby Azure Health Data Services stabilní, můžete začít používat službu FHIR služby Azure Health Data Services, která vyhovuje vašim obchodním scénářům. Vypněte všechny zbývající kanály spuštěné v rozhraní Azure API for FHIR. V případě potřeby odstraňte data z zprostředkujícího účtu úložiště, který byl použit v nástroji pro migraci. Odstraňte data ze serveru Azure API for FHIR a vyřaďte z provozu účet Azure API for FHIR.

Poznámka:

FHIR® je registrovaná ochranná známka HL7 a používá se s povolením HL7.