Estratégias de migração para mover 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 dos Serviços de Dados de Saúde do Azure para serviço FHIR 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 dos Serviços de Dados de Saúde do Azure para serviço FHIR é a versão evoluída da API do Azure para FHIR que permite aos clientes gerenciar os serviços FHIR, DICOM e serviço de tecnologia médica com integrações a outros serviços do Azure.
O serviço FHIR dos Serviços de Dados de Saúde do Azure é a plataforma de última geração para integração de dados de saúde. Ele oferece serviços de FHIR, DICOM e tecnologia médica de nível empresarial gerenciados para uma troca diversificada de dados de saúde.
Ao migrar 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 funcionalidades 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 do 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 ajudar você a avaliar sua preparação, preparar seus dados, migrar seus aplicativos e transferi-los 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: Transferência 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 | Com suporte: • RBAC local • Proxy do SMART no FHIR |
Reprovação planejada: • RBAC local (6/9/23) • Proxy do SMART no FHIR (21/9/26) |
| Volume de armazenamento de dados | Menor que 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 software de código aberto | Operação $import |
| Dimensionamento automático | Com suporte mediante solicitação e sujeito a cobrança | Habilitada por padrão sem custo adicional |
| Parâmetros de pesquisa | Tipo de pacote com suporte: Lote • Sem suporte para inclusão e revinclude e iteração de modificador • Classificação com suporte por nome, sobrenome, data de nascimento e data clínica |
Tipo de pacote com suporte: Lote e transação • Parâmetros de pesquisa selecionáveis • Com suporte para inclusão, revinclude e iteração do modificador • Classificação com suporte por campos de cadeia de caracteres e dateTime |
| Eventos | Sem suporte | Com suporte |
| Infraestrutura | Com suporte: • Chaves gerenciadas pelo cliente • Suporte ao AZ e à PITR • DR entre regiões |
Com suporte: • Recuperação de dados • Chaves gerenciadas pelo cliente Próximos: • Suporte à zona de disponibilidade |
Itens a considerar que podem afetar a sua arquitetura
O agente de sincronização está sendo preterido. Se 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 Proxy FHIR está sendo preterido. Se você estiver usando o FHIR Proxy para eventos, confira o recurso interno de eventos. As alternativas podem ser personalizadas e criadas com o kit de ferramentas dos Serviços de Dados de Saúde do Azure.
O proxy SMART on FHIR está sendo preterido. Você precisa usar a nova funcionalidade SMART on FHIR. Mais informações: SMART on FHIR
O serviço FHIR dos Serviços de Dados de Saúde do Azure não dá suporte ao RBAC local nem à autoridade personalizada. A autoridade do emissor do token precisa ser o ponto de extremidade de autenticação para o locatário em o Serviço FHIR está sendo executado.
só há suporte para o conector de IoT por meio de um serviço da API do Azure para FHIR. O Conector IoT é sucedido pelo serviço de tecnologia médica. Você precisa implantar um serviço de tecnologia médica 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 ao novo hub de eventos de dispositivo dos Hubs de Eventos do Azure. Use o dispositivo Conector IoT existente e os ficheiros de mapeamento de destino com a implantação do serviço de tecnologia médica.
Para migrar dados FHIR existentes do dispositivo Conector IoT de seu serviço 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 de tecnologia médica e reproduzir as mensagens do dispositivo IoT por meio do serviço de tecnologia médica.
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 para o tempo de inatividade, você pode optar por 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. O ideal é que o pipeline de dados possa permitir mais tempo de inatividade. | Escolha a opção que funciona melhor para sua organização: • Configure um fluxo de trabalho para usar $export a fim de exportar seus dados da API do Azure para FHIR e, em seguida use $import para importá-los para o serviço FHIR dos Serviços de Dados de Saúde do Azure. • O repositório GitHub traz dicas de como executar esses comandos e um script para ajudar a automatizar a criação do conteúdo de $import. • Ou, então, crie sua ferramenta para migrar os dados usando $export e $import. |
| Cópia incremental | Versão contínua de lift-and-shift, com menos tempo de inatividade. Ideal para volumes de dados grandes que levam mais tempo para serem copiados 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 de software de código aberto para ajudar com esse padrão de migração. • Ou, então, crie sua ferramenta para migrar os dados de maneira incremental. |
Considerações sobre a ferramenta de migração de software de código aberto
Se você decidir usar a ferramenta de migração de software de código aberto, analise e entenda as funcionalidades e as limitações da ferramenta de migração.
Preparar o servidor da API do Azure para FHIR
Identifique os dados a serem migrados.
Aproveite essa oportunidade para limpar os dados ou os servidores do FHIR que não são mais usados.
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 Saúde do Azure.
Primeiro, implante um workspace dos Serviços de Dados de Saúde do Azure.
Depois, implante um servidor do serviço FHIR dos Serviços de Dados de Saúde do Azure. Mais informações: Implantar um serviço FHIR nos Serviços de Dados de Saúde do Azure
Configure o 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 no seu novo servidor, confira a lista recomendada do que verificar na documentação da ferramenta de migração. Defina as configurações antes de migrar.
Etapa 3: Migrar os dados
Escolha o padrão de migração que funciona melhor para sua organização. Se estiver usando ferramentas de migração de software de código aberto, siga as instruções descritas no GitHub.
Etapa 4: Migrar aplicativos e redefinir configurações
Migre os aplicativos que apontavam para o servidor do FHIR antigo.
Altere os pontos de extremidade nos seus aplicativos para que eles apontem para a URL do novo servidor do FHIR.
Configure as permissões novamente para estes aplicativos.
Redefina as configurações restantes no novo servidor do serviço FHIR dos Serviços de Dados de Saúde do Azure após a migração.
Caso deseje verificar se o serviço FHIR dos Serviços de Dados de Saúde do Azure e os servidores da API do Azure para FHIR têm as mesmas configurações, verifique os dois pontos de extremidade de metadados para comparar os dois servidores.
Configure todos os trabalhos que estavam em execução anteriormente no servidor antigo da API do Azure para FHIR (por exemplo, trabalhos de $export)
Etapa 5: Transferência para os serviços FHIR dos Serviços de Dados de Saúde do Azure
Depois de ter certeza de que o servidor do serviço FHIR dos Serviços de Dados de Saúde do Azure está estável, comece a usar o serviço FHIR dos Serviços de Dados de Saúde do Azure para atender aos seus cenários de negócios. Desative todos os pipelines restantes que estão em execução na API do Azure para FHIR, exclua os dados da conta de armazenamento intermediária usada na ferramenta de migração se necessário, exclua os dados do servidor da API do Azure para FHIR e desative sua conta da API do Azure para FHIR.