Estrategias de migración para migrar desde Azure API for FHIR
Importante
Azure API for FHIR se retirará el 30 de septiembre de 2026. Siga las estrategias de migración para realizar la transición al servicio FHIR de Azure Health Data Services en esa fecha. Debido a la retirada de Azure API for FHIR, no se permitirán nuevas implementaciones a partir del 1 de abril de 2025. El servicio FHIR de Azure Health Data Services es la versión evolucionada de Azure API for FHIR que permite a los clientes administrar los servicios FHIR, DICOM y MedTech con integraciones en otros servicios de Azure.
El servicio FHIR de Azure Health Data Services es la plataforma de última generación para la integración de datos de mantenimiento. Ofrece servicios administrados, FHIR de nivel empresarial, DICOM y MedTech para el intercambio de datos de salud diverso.
Al migrar los datos de FHIR de Azure API for FHIR al servicio FHIR de Azure Health Data Services, su organización puede beneficiarse de un rendimiento, escalabilidad, seguridad y cumplimiento mejorados. Las organizaciones también pueden acceder a nuevas características y funcionalidades que no están disponibles en Azure API for FHIR.
Azure API for FHIR se retirará el 30 de septiembre de 2026, por lo que debe migrar los datos de FHIR al servicio FHIR de Azure Health Data Services tan pronto como sea posible. Para facilitar el proceso, hemos creado algunas herramientas y sugerencias para ayudarle a evaluar la preparación, preparar los datos, migrar las aplicaciones y pasar al nuevo servicio.
Enfoque recomendado
Para migrar los datos, siga estos pasos:
- Paso 1: Evaluación de la preparación
- Paso 2: Preparación de la migración
- Paso 3: Migración de los datos y las cargas de trabajo de las aplicaciones
- Paso 4: Migración de Azure API for FHIR a Azure Health Data Services
Paso 1: Evaluación de la preparación
Compare las diferencias entre Azure API for FHIR y Azure Health Data Services. Revise también la arquitectura y evalúe si es necesario realizar algún cambio.
| Funcionalidades | Azure API for FHIR | Azure Health Data Services |
|---|---|---|
| Configuración | Apoyado: • RBAC local • SMART on FHIR Proxy |
Desuso planeado: • RBAC local (6/9/23) • SMART on FHIR Proxy (9/21/26) |
| Volumen de almacenamiento de datos | Más de 4 TB | La compatibilidad actual es de 4 TB (abra una solicitud de Soporte técnico de Azure si necesita más de 4 TB) |
| Entrada de datos | Herramientas disponibles en OSS | operación de $import |
| Escalabilidad automática | Se admite en la solicitud e incurre en cargos | Habilitado de forma predeterminada sin cargo adicional |
| Parámetros de búsqueda | Tipo de lote admitido: Batch • No se admite el modificador de inclusión y revinclusión, iteración • Ordenación admitida por nombre, apellidos, fecha de nacimiento y fecha clínica |
Tipo de lote admitido: Batch y transaction • Parámetros de búsqueda seleccionables • Se admite incluir, revincluir y iterar modificador • Ordenación admitida por campos de cadena y dateTime |
| Eventos | No compatible | Compatible |
| Infraestructura | Apoyado: • Claves administradas por el cliente • Compatibilidad con AZ y PITR • Recuperación ante desastres entre regiones |
Apoyado: • Recuperación de datos • Claves administradas por el cliente Próximos: • Soporte de zona de disponibilidad |
Aspectos que se deben tener en cuenta que pueden afectar a la arquitectura
El agente de sincronización está en desuso. Si usa el agente de sincronización para conectarse a Dataverse, consulte Introducción al kit de herramientas de integración de datos.
El proxy de FHIR está en desuso. Si usa el proxy de FHIR para eventos, consulte la característica de eventos integrada. Las alternativas se pueden personalizar y crear mediante el kit de herramientas de Azure Health Data Services.
Smart on FHIR proxy está en desuso. Debe usar la nueva funcionalidad SMART on FHIR. Más información: SMART on FHIR
El servicio FHIR de Azure Health Data Services no admite RBAC local ni autoridad personalizada. La entidad emisora de tokens debe ser el punto de conexión de autenticación del inquilino en el que se ejecuta el servicio FHIR.
El conector de IoT solo se admite mediante un servicio Azure API for FHIR. El servicio MedTech realiza correctamente el conector de IoT. Debe implementar un servicio MedTech y el servicio FHIR correspondiente dentro de un área de trabajo existente o nueva de Azure Health Data Services y apuntar los dispositivos al nuevo centro de eventos de dispositivo de Azure Events Hubs. Use los archivos de asignación de destino y dispositivo del conector de IoT existentes con la implementación del servicio MedTech.
Si quiere migrar los datos de FHIR del dispositivo del conector ioT existentes desde el servicio Azure API for FHIR al servicio FHIR de Azure Health Data Services, use la funcionalidad de exportación e importación masiva en la herramienta de migración. Otra ruta de migración sería implementar un nuevo servicio MedTech y reproducir los mensajes del dispositivo IoT a través del servicio MedTech.
Paso 2: Preparación de la migración
En primer lugar, cree un plan de migración. Se recomiendan los patrones de migración descritos en la tabla. En función de la tolerancia de su organización para el tiempo de inactividad, puede decidir usar determinados patrones y herramientas para facilitar la migración.
| Patrón de migración | Detalles | ¿Cómo lo hago? |
|---|---|---|
| Elevación y desplazamiento | El patrón más simple. Ideal si la canalización de datos puede permitir un tiempo de inactividad más largo. | Elija la opción que mejor funcione para su organización: • Configure un flujo de trabajo para $export los datos en Azure API for FHIR y, a continuación , $import en el servicio FHIR de Azure Health Data Services. • El repositorio de GitHub proporciona sugerencias sobre cómo ejecutar estos comandos y un script para ayudar a automatizar la creación de la carga de $import. • O cree su propia herramienta para migrar los datos mediante $export y $import. |
| Copia incremental | Versión continua de lift-and-shift, con menos tiempo de inactividad. Ideal para grandes cantidades de datos que tardan más tiempo en copiarse o si desea seguir ejecutando Azure API for FHIR durante la migración. | Elija la opción que mejor funcione para su organización. • Hemos creado una herramienta de migración del sistema operativo para ayudar con este patrón de migración. • O cree su propia herramienta para migrar los datos de forma incremental. |
Consideraciones sobre la herramienta de migración de OSS
Si decide usar la herramienta de migración del sistema operativo, revise y comprenda las funcionalidades y limitaciones de la herramienta de migración.
Preparación del servidor de Azure API for FHIR
Identifique los datos que se van a migrar.
Aproveche esta oportunidad para limpiar los datos o los servidores FHIR que ya no use.
Decida si desea migrar versiones históricas o no.
Implemente un nuevo servidor de servicio FHIR de Azure Health Data Services.
En primer lugar, implemente un área de trabajo de Azure Health Data Services.
A continuación, implemente un servidor de servicio FHIR de Azure Health Data Services. Más información: Implementación de un servicio de FHIR en Azure Health Data Services
Configure el nuevo servidor de servicio FHIR de Azure Health Data Services. Si necesita usar las mismas configuraciones que tiene en Azure API for FHIR para el nuevo servidor, consulte la lista recomendada de qué comprobar en la documentación de la herramienta de migración. Configure las opciones antes de migrar.
Paso 3: Migración de datos
Elija el patrón de migración que mejor funcione para su organización. Si usa herramientas de migración del sistema operativo, siga las instrucciones de GitHub.
Paso 4: Migrar aplicaciones y volver a configurar la configuración
Migre las aplicaciones que apuntaban al servidor FHIR antiguo.
Cambie los puntos de conexión de las aplicaciones para que apunten a la nueva dirección URL del servidor FHIR.
Vuelva a configurar los permisos para estas aplicaciones.
Vuelva a configurar cualquier configuración restante en el nuevo servidor de servicio FHIR de Azure Health Data Services después de la migración.
Si desea hacer doble comprobación para asegurarse de que el servicio FHIR de Azure Health Data Services y los servidores de Azure API for FHIR tienen las mismas configuraciones, puede comprobar ambos puntos de conexión de metadatos para comparar y contrastar los dos servidores.
Configure los trabajos que se estaban ejecutando anteriormente en el servidor antiguo de Azure API for FHIR (por ejemplo, $export trabajos)
Paso 5: Migración a los servicios FHIR de Azure Health Data Services
Una vez que esté seguro de que el servidor del servicio FHIR de Azure Health Data Services es estable, puede empezar a usar el servicio FHIR de Azure Health Data Services para satisfacer los escenarios empresariales. Desactive las canalizaciones restantes que se ejecutan en Azure API for FHIR, elimine los datos de la cuenta de almacenamiento intermedia que se usó en la herramienta de migración si es necesario, elimine los datos del servidor de Azure API for FHIR y retire la cuenta de Azure API for FHIR.