Perguntas frequentes sobre o serviço 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.
Esta seção aborda algumas das perguntas frequentes sobre o serviço FHIR® dos Serviços de Dados de Saúde do Azure.
Serviço FHIR: O básico
O que é FHIR?
O Fast Healthcare Interoperability Resources (FHIR) é uma norma de interoperabilidade destinada a permitir o intercâmbio de dados de cuidados de saúde entre diferentes sistemas de saúde. Este padrão foi desenvolvido pela organização HL7 e está sendo adotado por organizações de saúde em todo o mundo. A versão mais atual do FHIR disponível é R4 (Release 4). O serviço FHIR suporta R4 e a versão anterior STU3 (Standard for Trial Use 3). Para mais informações sobre a FHIR, visite HL7.org.
Os dados por trás das APIs FHIR são armazenados no Azure?
Sim, os dados são armazenados em bancos de dados gerenciados no Azure. O serviço FHIR nos Serviços de Dados de Saúde do Azure não fornece acesso direto ao armazenamento de dados subjacente.
Como posso ter acesso aos dados subjacentes?
No serviço gerenciado, não é possível acessar os dados subjacentes. Isso é para garantir que o serviço FHIR ofereça as certificações de privacidade e conformidade necessárias para dados de saúde. Se precisar de acesso aos dados subjacentes, pode utilizar o servidor FHIR de código aberto.
Que provedor de identidade você suporta?
Suportamos o Microsoft Entra ID e o provedor de identidade de terceiros que suporta o OpenID connect.
Posso usar o Azure AD B2C com o serviço FHIR?
Sim. Você pode usar o Azure Ative Directory B2C (Azure AD B2C) com o serviço FHIR para conceder acesso aos seus aplicativos e usuários. Para obter mais informações, consulte Usar o Azure Ative Directory B2C para conceder acesso ao serviço FHIR.
Qual versão FHIR você suporta?
Suportamos as versões 4.0.0 e 3.0.1.
Para obter mais informações, consulte Recursos FHIR suportados. Você também pode ler sobre o que mudou entre as versões FHIR (STU3 a R4) no histórico de versões do HL7 FHIR.
Qual é a diferença entre a API do Azure para FHIR e o serviço FHIR nos Serviços de Dados de Saúde do Azure?
A API do Azure para FHIR foi o nosso produto inicial disponível em geral e está a ser desativada a partir de 30 de setembro de 2026. A tabela a seguir descreve as diferenças entre a API do Azure para FHIR e os Serviços de Dados de Saúde do Azure, serviço FHIR.
| Capacidades | Azure API for FHIR | Serviços de Dados de Saúde do Azure |
|---|---|---|
| Entrada de dados | Ferramentas disponíveis em OSS | $import operação. Para obter informações, visite Operação de importação |
| Dimensionamento automático | Suportado a pedido e incorre em custos | Dimensionamento automático 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 suportada por 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 |
| Conversão de dados | Suporta a ativação de "Permitir serviços confiáveis" no registro de contêiner de conta | Há um problema conhecido: habilitar o link privado com o Registro de Contêiner do Azure pode resultar em problemas de acesso ao tentar usar o Registro de contêiner do serviço FHIR. |
| Continuidade do negócio | Suportado: • DR (recuperação de desastres) entre regiões |
Suportado: • PITR (recuperação point-in-time) • Suporte à zona de disponibilidade |
Por padrão, cada instância FHIR dos Serviços de Dados de Saúde do Azure é limitada à capacidade de armazenamento de 4 TB. Para provisionar uma instância FHIR com capacidade de armazenamento superior a 4TB, crie uma solicitação de suporte com o tipo de problema 'Limite de serviço e assinatura (cotas)'.
Qual é a diferença entre o serviço FHIR nos Serviços de Dados de Saúde do Azure e o servidor FHIR de código aberto?
O serviço FHIR nos Serviços de Dados de Saúde do Azure é uma versão hospedada e gerenciada do Microsoft FHIR Server for Azure de código aberto. No serviço gerenciado, a Microsoft fornece toda a manutenção e atualizações.
Ao executar o Servidor FHIR para Azure, você tem acesso direto aos serviços subjacentes, mas somos responsáveis por manter e atualizar o servidor e todo o trabalho de conformidade necessário se você estiver armazenando dados PHI.
Em que regiões está disponível o serviço FHIR?
O serviço FHIR está disponível em todas as regiões em que os Serviços de Dados de Saúde do Azure estão disponíveis. Você pode ver as regiões suportadas na página Produtos por região .
Onde posso ver o que está liberando no serviço FHIR?
A página de notas de versão fornece uma visão geral de tudo o que foi enviado para o serviço gerenciado no mês anterior.
Para ver o que será liberado para o serviço gerenciado, você pode revisar a página de lançamentos do servidor FHIR de código aberto. Trabalhamos para marcar itens com os Serviços de Dados de Integridade do Azure se eles forem lançados para o serviço gerenciado e estiverem disponíveis duas semanas depois de estarem na página de versão de código aberto. Também incluímos instruções sobre como testar a compilação, se você quiser testar em seu próprio ambiente. Estamos avaliando a melhor forma de compartilhar atualizações adicionais de serviços gerenciados.
Para ver qual pacote de versão está atualmente no serviço gerenciado, você pode exibir a declaração de capacidade para o serviço FHIR e sob a software.version propriedade. Você verá qual pacote é implantado.
Onde posso encontrar qual versão do FHIR (R4/STU3) está sendo executada no meu banco de dados?
Você pode encontrar a versão exata do FHIR exposta na instrução de capacidade sob a fhirVersion propriedade (URL FHIR/metadados).
Posso mudar o meu serviço FHIR de STU3 para R4?
N.º Não temos como alterar a versão de um banco de dados existente. Você precisará criar um novo serviço FHIR e recarregar os dados. Você pode aproveitar o conversor JSON para FHIR como um lugar para começar com a conversão de dados STU3 em R4.
Posso personalizar o URL do meu serviço FHIR?
N.º Não é possível alterar o URL do serviço FHIR.
Quais são os limites associados ao serviço FHIR nos Serviços de Dados de Saúde do Azure?
Consulte a seção "Limites de serviço" em Limites de serviço do Azure FHIR
Implementações e especificações FHIR
O que é SMART no FHIR?
O SMART (Substitutable Medical Applications and Reusable Technology) no FHIR é um conjunto de especificações abertas para integrar aplicações de parceiros com servidores FHIR e outros sistemas informáticos de saúde, tais como registos de saúde eletrónicos e intercâmbios de informações de saúde. Ao criar um aplicativo SMART on FHIR, você pode garantir que seu aplicativo possa ser acessado e usado por muitos sistemas diferentes. Para obter mais informações sobre SMART, consulte SMART Health IT.
O serviço FHIR suporta SMART no FHIR?
Sim, a capacidade SMART on FHIR é suportada usando amostras AHDS. Isto é referido como SMART em FHIR (Melhorado). O SMART on FHIR(Enhanced) pode ser considerado para atender aos requisitos com o SMART on FHIR Implementation Guide (v 1.0.0) e §170.315(g)(10) Standardized API for patient and population services criterion. Para obter mais informações, visite SMART on FHIR(Enhanced) Documentation.
Posso criar um recurso FHIR personalizado?
Não permitimos recursos FHIR personalizados. Se você precisar de um recurso FHIR personalizado, poderá criar um recurso personalizado sobre o recurso Básico com extensões.
As extensões são suportadas no serviço FHIR?
Sim. Permitimos que você carregue quaisquer dados JSON FHIR válidos no servidor. Se você quiser armazenar a definição de estrutura que define extensões, poderá salvá-la como um recurso de definição de estrutura. Para pesquisar em extensões, você precisará definir seus próprios parâmetros de pesquisa.
Como posso ver o serviço FHIR em XML?
No serviço gerenciado, suportamos apenas JSON. O servidor FHIR de código aberto suporta JSON e XML. Para exibir a versão XML em código aberto, use _format= application/fhir+xml.
Qual é o limite de _count?
O limite atual de _count é de 1000. Se você definir _count para mais de 1000, receberá um aviso no pacote informando que apenas 1.000 registros serão exibidos.
Posso publicar um pacote no serviço FHIR?
Atualmente, suportamos a publicação de pacotes em lote e a publicação de pacotes de transações no serviço FHIR.
Como posso obter todos os recursos para um único paciente no serviço FHIR?
Apoiamos a operação de $patient-tudo, que lhe fornece todos os dados relacionados com um único paciente.
O serviço FHIR suporta alguma operação terminológica?
Não, o serviço FHIR não suporta atualmente operações de terminologia.
Usando o serviço FHIR
Posso realizar verificações de saúde no serviço FHIR?
Para executar uma verificação de integridade em um serviço FHIR, insira {{fhirurl}}/health/check a solicitação GET. Você deve ser capaz de ver o status do serviço FHIR. Uma resposta de código de status HTTP com 200 e OverallStatus como Íntegro significa que sua verificação de integridade foi bem-sucedida.
Se houver erros, você pode receber uma resposta de erro com o código de status HTTP 404 (Não encontrado) ou o código de status 500 (Erro interno do servidor) e informações detalhadas no corpo da resposta.
Quais são os métodos recomendados para sincronizar dados entre o serviço FHIR e o Dataverse?
Consulte a documentação das APIs de saúde do Dataverse
Próximos passos
Neste artigo, você aprendeu as respostas para perguntas frequentes sobre o serviço FHIR. Para ver as perguntas frequentes sobre o serviço FHIR na API do Azure para FHIR, consulte
Nota
FHIR® é uma marca registada da HL7 e é utilizada com a permissão da HL7.