Strategie migracji z Azure API dla FHIR

Ważne

Usługa Azure API for FHIR zostanie wycofana 30 września 2026 r. Postępuj zgodnie ze strategiami migracji, aby przejść do usługi Azure Health Data Services FHIR® do tej daty. Ze względu na wycofanie usługi Azure API for FHIR nowe wdrożenia klientów nie będą dozwolone od 1 kwietnia 2025 r. Usługa Azure Health Data Services FHIR to rozwinięta wersja usługi Azure API for FHIR, która umożliwia klientom zarządzanie usługami FHIR i DICOM przy użyciu integracji z innymi usługami platformy Azure.

Usługa FHIR® w ramach Azure Health Data Services to platforma nowej generacji do integracji danych zdrowotnych. Oferuje ona zarządzane, klasy korporacyjnej usługi FHIR i DICOM na potrzeby zróżnicowanej wymiany danych zdrowotnych.

Dzięki migracji danych FHIR z usługi Azure API for FHIR do usługi Azure Health Data Services FHIR organizacja może poprawić wydajność, skalowalność, zabezpieczenia i zgodność z przepisami. Organizacje mogą również uzyskać dostęp do nowych funkcji i możliwości, które nie są dostępne w ramach usługi Azure API for FHIR.

Interfejs API platformy Azure dla standardu FHIR zostanie wycofany 30 września 2026 r., więc musisz przeprowadzić migrację danych FHIR do usługi FHIR usługi Azure Health Data Services tak szybko, jak to możliwe. Aby ułatwić ten proces, utworzyliśmy kilka narzędzi i wskazówek, które pomogą Ci ocenić gotowość, przygotować dane, zmigrować aplikacje i przejść do nowej usługi.

Zalecane podejście

Aby przeprowadzić migrację danych, wykonaj następujące kroki.

• Krok 1. Ocena gotowości
• Krok 2. Przygotowanie do migracji
• Krok 3. Migrowanie danych i obciążeń aplikacji
• Krok 4. Przechodzenie z interfejsu API platformy Azure dla standardu FHIR do usług Azure Health Data Services

Krok 1. Ocena gotowości

Porównaj różnice między usługami Azure API for FHIR i Azure Health Data Services. Zapoznaj się również z architekturą i oceń, czy należy wprowadzić jakiekolwiek zmiany.

Możliwości	Azure API for FHIR	Azure Health Data Services
Ustawienia	Obsługiwane: • Lokalny RBAC • SMART na serwerze proxy FHIR	Planowane wycofanie: • Lokalna kontrola dostępu oparta na rolach (9/6/23) • SMART on FHIR Proxy (21.09.2026)
Wolumin magazynu danych	Więcej niż 4 TB	Obecne wsparcie wynosi 4 TB. Otwórz żądanie pomocy technicznej platformy Azure, jeśli potrzebujesz więcej niż 4 TB
Wejście danych	Narzędzia dostępne w systemie operacyjnym	$import operacja
Skalowanie automatyczne	Obsługiwanie na żądanie i wiąże się z opłatą.	Domyślnie włączone bez dodatkowych opłat
Parametry wyszukiwania	Obsługiwany typ pakietu: Batch • Uwzględnianie i ponowne uwzględnianie, modyfikator iteracji nieobsługiwany • Sortowanie obsługiwane przez imię, nazwisko rodzinne, data urodzenia i data kliniczna	Obsługiwany typ pakietu: Zbiorczy i transakcyjny • Wybieralne parametry wyszukiwania • Obsługiwane jest dołączanie, ponowne pobieranie i iterowanie modyfikatora • Sortowanie obsługiwane przez ciągi i pola daty i czasu
Wydarzenia	Niewspierany	Obsługiwane
Infrastruktura	Obsługiwane: • Klucze zarządzane przez klienta • Odzyskiwanie po awarii między regionami	Obsługiwane: • PITR (odzyskiwanie do punktu w czasie) • Klucze zarządzane przez klienta Nadchodzące • Obsługa stref dostępności

Ważne

Jeśli wystąpienie usługi Azure API for FHIR zawiera więcej niż 2 TB danych, otwórz zgłoszenie do pomocy technicznej platformy Azureprzed rozpoczęciem migracji. W zgłoszeniu do pomocy technicznej podaj nazwę instancji usługi Azure API for FHIR oraz nazwę instancji usługi FHIR w Azure Health Data Services, aby zespół mógł pomóc w zaplanowaniu migracji.

Kwestie do rozważenia, które mogą mieć wpływ na architekturę

• Agent synchronizacji jest wycofywany. Jeśli korzystasz z agenta synchronizacji do nawiązywania połączenia z platformą Dataverse, zobacz temat Omówienie zestawu narzędzi do integracji danych

• Serwer proxy FHIR jest wycofywany. Jeśli korzystasz z FHIR Proxy do obsługi zdarzeń, zapoznaj się z wbudowaną funkcją obsługi zdarzeń. Alternatywne rozwiązania można dostosować i skompilować przy użyciu zestawu narzędzi Azure Health Data Services.

• Funkcja SMART na serwerze proxy FHIR jest wycofywana. Musisz użyć nowej funkcji SMART na platformie FHIR. Więcej informacji: SMART on FHIR

• Usługa FHIR w ramach Azure Health Data Services nie obsługuje lokalnej kontroli dostępu opartej na rolach ani niestandardowej autoryzacji. Organ wydający token musi być punktem końcowym uwierzytelniania dla najemcy, w którym działa usługa FHIR.

• Łącznik IoT jest obsługiwany tylko przy użyciu usługi Azure API for FHIR. Jeśli chcesz przeprowadzić migrację istniejących danych interfejsu FHIR łącznika IoT z usługi Azure API for FHIR do usługi Azure Health Data Services FHIR, użyj funkcji eksportu zbiorczego i importowania w narzędziu do migracji.

Krok 2. Przygotowanie do migracji

Najpierw utwórz plan migracji. Zalecamy wzorce migracji opisane w poniższej tabeli. W zależności od tolerancji przestojów w organizacji możesz użyć pewnych wzorców i narzędzi, aby ułatwić migrację.

Wzorzec migracji	Szczegóły	W jaki sposób?
Podnieś i przenieś	Najprostszy wzorzec. Idealne rozwiązanie, jeśli potok danych może pozwolić na dłuższy przestój.	Wybierz opcję, która najlepiej sprawdza się w twojej organizacji: • Skonfiguruj przepływ pracy w celu $wyeksportowania danych w usłudze Azure API for FHIR, a następnie $zaimportowania do usługi Azure Health Data Services FHIR. • Repozytorium GitHub zawiera wskazówki dotyczące uruchamiania tych poleceń oraz skrypt, który ułatwia zautomatyzowanie tworzenia ładunku $import. • Utwórz własne narzędzie do migracji danych przy użyciu $export i $import.
Kopia przyrostowa	Ciągła implementacja metodą "lift and shift" z mniejszym przestojem. Idealne rozwiązanie w przypadku dużych ilości danych, które wymagają więcej czasu na skopiowanie, lub jeśli chcesz kontynuować działanie interfejsu API Azure for FHIR podczas migracji.	Wybierz opcję, która będzie najkorzystniejsza dla Twojej organizacji. • Utworzyliśmy narzędzie do migracji systemu operacyjnego, aby ułatwić korzystanie z tego wzorca migracji. • Utwórz własne narzędzie, aby migrować dane przyrostowo.

Zagadnienia dotyczące narzędzia migracji systemu operacyjnego

Jeśli zdecydujesz się użyć narzędzia do migracji systemu operacyjnego, przejrzyj i zapoznaj się z możliwościami i ograniczeniami narzędzia migracji.

Przygotowywanie interfejsu API platformy Azure dla serwera FHIR

Zidentyfikuj dane do migracji.

• Skorzystaj z tej okazji, aby wyczyścić dane lub serwery FHIR, których już nie używasz.

• Zdecyduj, czy chcesz przeprowadzić migrację wersji historycznych, czy nie.

Wdróż nowy serwer usługi Azure Health Data Services FHIR.

• Najpierw wdróż obszar roboczy usługi Azure Health Data Services.

• Następnie wdróż serwer FHIR usługi Azure Health Data Services. Więcej informacji można znaleźć tutaj: Wdrażanie usługi FHIR w usługach Azure Health Data Services.

• Skonfiguruj nowy serwer usługi Azure Health Data Services FHIR. Jeśli musisz użyć tych samych konfiguracji, co w usłudze Azure API for FHIR dla nowego serwera, zapoznaj się z zalecaną listą elementów do sprawdzenia w dokumentacji narzędzia migracji. Skonfiguruj ustawienia przed migracją.

Krok 3. Migrowanie danych

Wybierz wzorzec migracji, który najlepiej sprawdza się w twojej organizacji. Jeśli używasz narzędzi migracji systemu operacyjnego, postępuj zgodnie z instrukcjami w witrynie GitHub.

Krok 4. Migrowanie aplikacji i ponowne konfigurowanie ustawień

Migruj aplikacje, które wskazywały na stary serwer FHIR.

• Zmień punkty końcowe w aplikacjach, aby wskazywały adres URL nowego serwera FHIR.

• Ponownie skonfiguruj uprawnienia dla tych aplikacji.

• Po migracji ponownie skonfiguruj wszystkie pozostałe ustawienia na nowym serwerze usługi Azure Health Data Services FHIR.

• Jeśli chcesz dokładnie sprawdzić, czy usługa FHIR usług Azure Health Data Services i serwery azure API for FHIR mają te same konfiguracje, możesz sprawdzić oba punkty końcowe metadanych, aby porównać te dwa serwery.

• Skonfiguruj wszystkie zadania, które działały wcześniej na starym serwerze usługi Azure API for FHIR (na przykład $export zadania).

Krok 5. Przechodzenie do usług FHIR w Azure Health Data Services

Po upewnieniu się, że serwer usługi Azure Health Data Services FHIR jest stabilny, możesz rozpocząć korzystanie z usługi Azure Health Data Services FHIR w celu spełnienia Twoich scenariuszy biznesowych. Wyłącz wszystkie pozostałe potoki uruchomione w usłudze Azure API for FHIR. W razie potrzeby usuń dane z pośredniego konta przechowywania, które zostało użyte w narzędziu migracyjnym. Usuń dane z serwera usługi Azure API for FHIR i likwiduj konto usługi Azure API for FHIR.

Uwaga

FHIR® jest zastrzeżonym znakiem towarowym HL7 i jest używany z uprawnieniem HL7.