Estratégias de migração para mudar 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 gerir serviços FHIR, DICOM e MedTech com integrações noutros 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 saúde. Oferece serviços FHIR, DICOM e MedTech geridos de nível empresarial para diversos intercâmbios de dados de saúde.
Quando migra os seus dados FHIR da API do Azure para FHIR para o serviço FHIR dos Serviços de Dados de Saúde do Azure, a sua organização pode beneficiar-se de desempenho, escalabilidade, segurança e conformidade aprimorados. As organizações também podem aceder novos recursos 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 passar para o novo serviço.
Abordagem recomendada
Para migrar seus dados, siga estas etapas.
- Etapa 1: Avaliar a prontidã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 prontidã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.
| Capacidades | Azure API for FHIR | Serviços de Dados de Saúde do Azure |
|---|---|---|
| Definições | Suportado: • RBAC local • SMART em FHIR Proxy |
Preterição planejada: • RBAC local (9/6/23) • SMART em 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 em OSS | $import Funcionamento |
| Dimensionamento automático | Suportado a pedido e incorre em custos | Ativado por padrão sem custo adicional |
| Parâmetros de pesquisa | Tipo de pacote suportado: Batch • Incluir e reverincluir, iterar modificador não suportado • Classificação apoiada pelo nome, apelido, 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 por campos string e dateTime |
| Eventos | Não suportado | Suportado |
| Infraestruturas | Suportado: • Chaves gerenciadas pelo cliente • DR (recuperação de desastres) entre regiões |
Suportado: • PITR (recuperação point-in-time) • Chaves gerenciadas pelo cliente Futuro: • Suporte à zona de disponibilidade |
Aspetos a considerar que podem afetar a sua arquitetura
O agente de sincronização está a ser descontinuado. Se estiver a usar 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á a ser descontinuado. Se estiver a utilizar o FHIR Proxy para eventos, consulte a funcionalidade de eventos incorporada. As alternativas podem ser personalizadas e criadas ao utilizar o kit de ferramentas dos Serviços de Dados de Saúde do Azure.
SMART no proxy FHIR está a ser descontinuado. Precisa utilizar o novo recurso SMART on FHIR. Mais informações: SMART em FHIR
O serviço FHIR dos Serviços de Dados de Saúde do Azure não suporta RBAC local e autoridade personalizada. A autoridade do emissor de token precisa ser o ponto de extremidade de autenticação para o tenant no qual o Serviço FHIR está a ser executado.
O conector IoT só é suportado usando uma API do Azure para serviço FHIR. O conector IoT é sucedido pelo serviço MedTech. Você precisa implantar um serviço MedTech e o 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. Utilize o dispositivo do conector IoT existente e os arquivos de mapeamento de destino com a implantação do serviço MedTech.
Se quiser migrar dados FHIR existentes do dispositivo de conector IoT do 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, utilize 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 através 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 a seguir. 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? |
|---|---|---|
| Elevador e mudança | 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 a 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 GitHub fornece dicas sobre como executar esses comandos e um script para ajudar a automatizar a criação da $import carga útil. • Crie sua própria ferramenta para migrar os dados usando $export e $import. |
| Cópia incremental | Versão contínua de elevação e mudança, com menos tempo de inatividade. Ideal para grandes quantidades de dados que demoram mais tempo a copiar ou se pretender continuar a executar a API do Azure para FHIR durante a migração. | Escolha a opção mais adequada à sua organização. • Criamos uma ferramenta de migração OSS para ajudar com esse padrão de migração. • Crie sua própria ferramenta para migrar os dados incrementalmente. |
Considerações sobre a ferramenta de migração OSS
Se você decidir usar a ferramenta de migração OSS, analise e compreenda os recursos e limitações da ferramenta de migração.
Preparar a API do Azure para o servidor FHIR
Identifique os 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 Saúde do Azure.
Primeiro, implante um espaço de trabalho dos Serviços de Dados de Saúde do Azure.
Em seguida, implante um servidor do Serviço FHIR dos Serviços de Dados de Saúde do Azure. Mais informações são encontradas aqui: 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 você 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. Configure as configurações antes de migrar.
Etapa 3: Migrar dados
Escolha o padrão de migração que funciona melhor para a sua organização. Se você estiver usando ferramentas de migração OSS, siga as instruções no GitHub.
Etapa 4: Migrar aplicativos e reconfigurar as 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 as permissões novamente para esses aplicativos.
Após a migração, reconfigure as configurações restantes no novo servidor de serviço FHIR dos Serviços de Dados de Saúde do Azure.
Se quiser verificar 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 ambos os pontos de extremidade de metadados para comparar os dois servidores.
Configure todos os trabalhos que estavam sendo executados anteriormente em sua antiga API do Azure para servidor FHIR (por exemplo,
$exporttrabalhos)
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 de Serviço FHIR dos Serviços de Dados de Saúde do Azure está 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 que estão sendo executados na API do Azure para FHIR. Se necessário, exclua os dados da conta de armazenamento intermediário usada na ferramenta de migração. Exclua dados da sua API do Azure para servidor FHIR e encerre sua conta da API do Azure para FHIR.
Nota
FHIR® é uma marca registada da HL7 e é utilizada com a permissão da HL7.