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 a 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 la API de Azure para FHIR que permite a los clientes administrar FHIR, DICOM y los servicios de tecnologías médicas 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 de tecnologías médicas 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, la 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 realizar la transición 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: Transició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 | Compatible: • RBAC local • Proxy de SMART on FHIR |
Desuso planeado: • RBAC local (6/9/23) • Proxy de SMART on FHIR (21/9/26) |
| Volumen de almacenamiento de datos | Más de 4 TB | El soporte 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 software de código abierto (OSS) | Operation de $import: |
| Escalabilidad automática | Se admite a petición y genera cargos | Habilitado de forma predeterminada sin cargo adicional |
| Parámetros de búsqueda | Tipo de agrupación admitido: lote • Inclusión e inclusión inversa, modificador de iteración no admitido • Ordenación admitida por nombre, nombre de familia, fecha de nacimiento y fecha clínica |
Tipo de agrupación admitido: lote y transacción • Parámetros de búsqueda seleccionables • Inclusión, inclusión inversa y modificador de iteración admitido • Ordenación admitida por los campos string y dateTime |
| Eventos | No compatible | Compatible |
| Infraestructura | Compatible: • Claves administradas por el cliente • DR entre regiones (recuperación ante desastres) |
Compatible: • PITR (recuperación a un momento dado) • Claves administradas por el cliente Próximamente: • Compatibilidad con zonas 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, vea 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.
El proxy de SMART en FHIR 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 de FHIR.
El conector de IoT solo se admite mediante un servicio de Azure API for FHIR. El servicio MedTech realiza correctamente el conector de IoT. Debe implementar un servicio de tecnologías médicas y el servicio FHIR correspondiente dentro de un área de trabajo de Azure Health Data Services existente o nueva 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 de 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 desde el 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 siguiente. Dependiendo de la tolerancia que su organización tenga para el tiempo de inactividad, puede decidir usar ciertos 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 su canalización de datos puede permitirse un tiempo de inactividad más largo. | Elija la opción que mejor se adecue a 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. • 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 de OSS para ayudar con este patrón de migración. • 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 de OSS, 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 servidores de FHIR que ya no usa.
Decida si desea migrar versiones históricas o no.
Implementación de 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. Aquí encontrará más información: Implementación de un servicio FHIR en Azure Health Data Services.
Configure el nuevo servidor de servicio FHIR de Azure Health Data Services. Si necesita usar en el nuevo servidor las mismas configuraciones que tiene en Azure API for FHIR, consulte la lista de lo que se recomienda 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 se adecue a su organización. Si usa herramientas de migración de OSS, siga las instrucciones de GitHub.
Paso 4: Migrar aplicaciones y volver a configurar las opciones
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.
Después de la migración, vuelva a configurar cualquier configuración restante en el nuevo servidor de servicio FHIR de Azure Health Data Services.
Si desea comprobar 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 los dos servidores.
Configure los trabajos que se ejecutaron anteriormente en el servidor antiguo de Azure API for FHIR (por ejemplo,
$exporttrabajos)
Paso 5: Transición a los servicios FHIR de Azure Health Data Services
Después de asegurarse de que el servidor de 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. Si es necesario, elimine los datos de la cuenta de almacenamiento intermedia que se usó en la herramienta de migración. Elimine los datos del servidor de Azure API for FHIR y retire la cuenta de Azure API for FHIR.
Nota:
FHIR® es una marca registrada de HL7 y se usa con su permiso.