Estratégias de migração para migrar da API do Azure para FHIR
Importante
A API do Azure para FHIR será desativada em 30 de setembro de 2026. Siga as estratégias de migração para fazer a transição para o serviço FHIR dos Serviços de Dados de Saúde do Azure até essa data. Devido à desativação da API do Azure para FHIR, novas implantações não serão permitidas a partir de 1º de abril de 2025. O serviço FHIR dos Serviços de Dados de Saúde do Azure é a versão evoluída da API do Azure para FHIR que permite aos clientes gerenciar serviços FHIR, DICOM e MedTech com integrações em outros serviços do Azure.
O serviço FHIR dos Serviços de Dados de Saúde do Azure é a plataforma de próxima geração para integração de dados de integridade. Ele oferece serviços FHIR, DICOM e MedTech gerenciados de nível empresarial para troca de dados de saúde diversos.
Quando você migra seus dados FHIR da API do Azure para FHIR para o serviço FHIR dos Serviços de Dados de Saúde do Azure, sua organização pode se beneficiar de desempenho, escalabilidade, segurança e conformidade aprimorados. As organizações também podem acessar novos recursos e capacidades que não estão disponíveis na API do Azure para FHIR.
A API do Azure para FHIR será desativada em 30 de setembro de 2026, portanto, você precisa migrar seus dados FHIR para o serviço FHIR dos Serviços de Dados de Saúde do Azure assim que possível. Para facilitar o processo, criamos algumas ferramentas e dicas para ajudá-lo a avaliar sua prontidão, preparar seus dados, migrar seus aplicativos e migrar para o novo serviço.
Abordagem recomendada
Para migrar seus dados, siga estas etapas:
- Etapa 1: Avaliar a preparação
- Etapa 2: Preparar para migrar
- Etapa 3: Migrar dados e cargas de trabalho de aplicativos
- Etapa 4: Transferir da API do Azure para FHIR para os Serviços de Dados de Saúde do Azure
Etapa 1: Avaliar a preparação
Compare as diferenças entre a API do Azure para FHIR e os Serviços de Dados de Saúde do Azure. Analise também sua arquitetura e avalie se alguma alteração precisa ser feita.
| Funcionalidades | API do Azure para FHIR | Serviços de Dados de Saúde do Azure |
|---|---|---|
| Configurações | Suportado: • RBAC local • SMART no Proxy FHIR |
Preterição planejada: • RBAC local (6/9/23) • SMART no Proxy FHIR (21/09/26) |
| Volume de armazenamento de dados | Mais de 4 TB | O suporte atual é de 4 TB (abra uma solicitação de suporte do Azure se precisar de mais de 4 TB) |
| Entrada de dados | Ferramentas disponíveis no OSS | $import operação |
| Dimensionamento automático | Suportado a pedido e incorre em encargos | Ativado por padrão sem custo adicional |
| Parâmetros de pesquisa | Tipo de pacote suportado: Batch • Incluir e rever, modificador de iteração não suportado • Classificação suportada por nome, sobrenome, data de nascimento e data clínica |
Tipo de pacote suportado: lote e transação • Parâmetros de pesquisa selecionáveis • O modificador Include, revinclude e iterate é suportado • Classificação suportada pelos campos string e dateTime |
| Eventos | Sem suporte | Com suporte |
| Infraestrutura | Suportado: • Chaves gerenciadas pelo cliente • Suporte AZ e PITR • DR de região cruzada |
Suportado: • Recuperação de dados • Chaves gerenciadas pelo cliente Próximo: • Suporte à zona de disponibilidade |
Coisas a considerar que podem afetar sua arquitetura
O agente de sincronização está sendo preterido. Se você estiver usando o agente de sincronização para se conectar ao Dataverse, consulte Visão geral do kit de ferramentas de integração de dados
O FHIR Proxy está sendo preterido. Se você estiver usando o FHIR Proxy para eventos, consulte o recurso interno de eventos. As alternativas podem ser personalizadas e criadas usando o kit de ferramentas do Azure Health Data Services.
O SMART no proxy FHIR está sendo preterido. Você precisa usar o novo recurso SMART on FHIR. Mais informações: SMART na FHIR
O serviço FHIR dos Serviços de Dados de Saúde do Azure não oferece suporte a RBAC local e autoridade personalizada. A autoridade do emissor do token precisa ser o ponto de extremidade de autenticação para o locatário no qual o Serviço FHIR está sendo executado.
O conector IoT só tem suporte usando uma API do Azure para o serviço FHIR. O conector IoT é sucedido pelo serviço MedTech. Você precisa implantar um serviço MedTech e um serviço FHIR correspondente em um espaço de trabalho existente ou novo dos Serviços de Dados de Saúde do Azure e apontar seus dispositivos para o novo hub de eventos de dispositivo dos Hubs de Eventos do Azure. Use o dispositivo conector IoT existente e os arquivos de mapeamento de destino com a implantação do serviço MedTech.
Se você quiser migrar dados FHIR de dispositivo conector IoT existentes de seu serviço FHIR da API do Azure para FHIR para o serviço FHIR dos Serviços de Dados de Saúde do Azure, use a funcionalidade de exportação e importação em massa na ferramenta de migração. Outro caminho de migração seria implantar um novo serviço MedTech e reproduzir as mensagens do dispositivo IoT por meio do serviço MedTech.
Etapa 2: Preparar para migrar
Primeiro, crie um plano de migração. Recomendamos os padrões de migração descritos na tabela. Dependendo da tolerância da sua organização ao tempo de inatividade, você pode decidir usar determinados padrões e ferramentas para ajudar a facilitar a migração.
| Padrão de migração | Detalhes | Como posso fazer isso? |
|---|---|---|
| Lift-and-shift | O padrão mais simples. Ideal se o seu pipeline de dados puder suportar um tempo de inatividade mais longo. | Escolha a opção que funciona melhor para sua organização: • Configure um fluxo de trabalho para $export seus dados na API do Azure para FHIR e, em seguida, $import no serviço FHIR dos Serviços de Dados de Saúde do Azure. • O repositório do GitHub fornece dicas sobre como executar esses comandos e um script para ajudar a automatizar a criação da carga útil $import. • Ou crie sua própria ferramenta para migrar os dados usando $export e $import. |
| Cópia incremental | Versão contínua de lift and shift, com menor tempo de inatividade. Ideal para grandes quantidades de dados que levam mais tempo para copiar ou se você quiser continuar executando a API do Azure para FHIR durante a migração. | Escolha a opção que funciona melhor para sua organização. • Criamos uma ferramenta de migração OSS para ajudar com este padrão de migração. • Ou crie sua própria ferramenta para migrar os dados de forma incremental. |
Considerações sobre a ferramenta de migração OSS
Se você decidir usar a ferramenta de migração OSS, revise e compreenda os recursos e limitações da ferramenta de migração.
Preparar a API do Azure para o servidor FHIR
Identificar dados a serem migrados.
Aproveite esta oportunidade para limpar dados ou servidores FHIR que você não usa mais.
Decida se deseja migrar versões históricas ou não.
Implante um novo servidor do Serviço FHIR dos Serviços de Dados de Integridade do Azure.
Primeiro, implante um espaço de trabalho do Azure Health Data Services.
Em seguida, implante um servidor de Serviço FHIR dos Serviços de Dados de Saúde do Azure. Para obter mais informações: Implantar um serviço FHIR nos Serviços de Dados de Saúde do Azure
Configure seu novo servidor do Serviço FHIR dos Serviços de Dados de Saúde do Azure. Se você precisar usar as mesmas configurações que tem na API do Azure para FHIR para seu novo servidor, consulte a lista recomendada do que verificar na documentação da ferramenta de migração. Defina as configurações antes de migrar.
Etapa 3: migrar dados
Escolha o padrão de migração que funciona melhor para sua organização. Se você estiver usando ferramentas de migração OSS, siga as instruções no GitHub.
Etapa 4: migrar aplicativos e redefinir configurações
Migre aplicativos que estavam apontando para o servidor FHIR antigo.
Altere os pontos de extremidade em seus aplicativos para que eles apontem para a URL do novo servidor FHIR.
Configure permissões novamente para esses aplicativos.
Redefina todas as configurações restantes no novo servidor do Serviço FHIR dos Serviços de Dados de Integridade do Azure após a migração.
Se você quiser verificar novamente se o Serviço FHIR dos Serviços de Dados de Saúde do Azure e a API do Azure para servidores FHIR têm as mesmas configurações, você pode verificar os dois pontos de extremidade de metadados para comparar e contrastar os dois servidores.
Configurar quaisquer trabalhos que estavam sendo executados anteriormente em sua API do Azure antiga para o servidor FHIR (por exemplo, trabalhos $export)
Etapa 5: Transferir para os serviços FHIR dos Serviços de Dados de Saúde do Azure
Depois de ter certeza de que seu servidor do Serviço FHIR dos Serviços de Saúde do Azure é estável, você pode começar a usar o serviço FHIR dos Serviços de Dados de Saúde do Azure para satisfazer seus cenários de negócios. Desative todos os pipelines restantes em execução na API do Azure para FHIR, exclua dados da conta de armazenamento intermediário que foi usada na ferramenta de migração, se necessário, exclua dados da API do Azure para servidor FHIR e descomissione sua conta da API do Azure para FHIR.