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 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.
Esta seção aborda algumas das perguntas frequentes sobre o serviço FHIR dos Serviços de Dados de Saúde do Azure (aqui chamado de serviço FHIR).
Serviço FHIR: O básico
O que é o FHIR?
O Fast Healthcare Interoperability Resources (FHIR - pronunciado "fire") é um padrão de interoperabilidade destinado a habilitar a troca de dados de saúde entre diferentes sistemas de integridade. Esse 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 é a R4 (versão 4). O serviço FHIR suporta R4 e a versão anterior STU3 (Standard for Trial Use 3). Para saber mais sobre o FHIR, visite HL7.org.
Os dados por trás das APIs do 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 obter acesso aos dados subjacentes?
No serviço gerenciado, você não pode 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, você poderá usar o servidor FHIR de código aberto.
A qual provedor de identidade você dá suporte?
Oferecemos suporte ao Microsoft Entra ID como provedor de identidade.
Posso usar o Azure AD B2C com o serviço FHIR?
Sim. Você pode usar o Azure Active Directory B2C (Azure AD B2C ) com o serviço FHIR para conceder acesso a seus aplicativos e usuários. Para obter mais informações, consulte Usar o Azure Active Directory B2C para conceder acesso ao serviço FHIR.
A qual versão do FHIR você dá suporte?
Damos suporte às versões 4.0.0 e 3.0.1.
Para obter mais informações, consulte Recursos FHIR com suporte. Você também pode ler sobre o que mudou entre as versões do FHIR (STU3 para 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 era nosso produto inicial disponível para o público geral e está sendo desativada em 30 de setembro de 2026. O serviço FHIR dos Serviços de Dados de Saúde do Azure oferece suporte a recursos adicionais, como:
Por padrão, cada instância do Azure Health Data Services, FHIR, é limitada à capacidade de armazenamento de 4 TB. Para provisionar uma instância FHIR com capacidade de armazenamento além de 4 TB, 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 no Azure Health Data Services é uma versão hospedada e gerenciada do Microsoft FHIR Server de código aberto para Azure. No serviço gerenciado, a Microsoft fornece todas as atualizações e a manutenção.
Ao executar o FHIR Server para Azure, você terá 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 estiver armazenando dados PHI.
Em quais regiões o serviço FHIR está disponível?
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 isso 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 dá uma visão geral de tudo o que já foi enviado para 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 versões do servidor FHIR de código aberto. Trabalhamos para marcar itens com os Serviços de Dados de Saúde do Azure se eles forem liberados para o serviço gerenciado e estiverem disponíveis duas semanas depois de estarem na página de lançamento em código aberto. Também incluímos instruções sobre como testar o build se você quiser testá-lo em seu próprio ambiente. Estamos avaliando a melhor forma de compartilhar atualizações adicionais de serviço gerenciado.
Para ver qual pacote de versão está atualmente no serviço gerenciado, você pode exibir a instrução de capacidade para o serviço FHIR e sob a software.version propriedade. Você verá qual pacote foi 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 FHIR exata exposta na instrução capability sob a fhirVersion propriedade (URL/metadados FHIR).
Posso mudar meu serviço FHIR de STU3 para R4?
Não. 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 tirar proveito do conversor JSON para FHIR como ponto de partida para converter dados STU3 em R4.
Posso personalizar o URL do meu serviço FHIR?
Não. Não é possível alterar a URL do serviço FHIR.
Implementações e especificações do FHIR
O que é SMART no FHIR?
SMART (Substitutable Medical Applications and Reusable Technology, Aplicativos Médicos Substituíveis e Tecnologia Reutilizável) no FHIR é um conjunto de especificações abertas para integrar aplicativos parceiros a servidores FHIR e outros sistemas de TI de integridade, como registros de saúde eletrônicos e trocas de informações de saúde. Ao criar um aplicativo SMART no FHIR, você pode fazer com que seu aplicativo possa ser acessado e aproveitado por uma infinidade de sistemas diferentes. Para obter mais informações sobre o SMART, consulte SMART Health IT.
O serviço FHIR suporta SMART no FHIR?
Sim, o recurso SMART em FHIR é suportado usando amostras AHDS. Isso é conhecido como SMART no FHIR(Enhanced). O SMART on FHIR(Avançado) pode ser considerado para atender aos requisitos com o Guia de Implementação do SMART on FHIR (v 1.0.0) e a API Padronizada do §170.315(g)(10) para conformidade com o critério de serviços de pacientes e população. Para obter mais informações, visite SMART na documentação FHIR(Enhanced).
Posso criar um recurso FHIR personalizado?
Não permitimos recursos FHIR personalizados. Se você precisar de um recurso FHIR personalizado, poderá criá-lo com base no recurso básico com extensões.
As extensões são suportadas no serviço FHIR?
Permitimos que você carregue qualquer dado JSON FHIR válido no servidor. Se você quiser armazenar a definição de estrutura que define a extensão, poderá salvá-la como um recurso de definição de estrutura. Para pesquisar nas 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, só damos suporte a JSON. O servidor FHIR de software livre dá suporte a JSON e XML. Para exibir a versão XML de código aberto, use _format= application/fhir+xml.
Qual é o limite de _count?
O limite atual de _count é 1000. Se você definir _count para mais de 1000, receberá um aviso no pacote de que apenas 1000 registros serão mostrados.
Posso enviar um pacote para o serviço FHIR?
Atualmente, oferecemos suporte ao lançamento de pacotes em lote e ao lançamento 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 $patient-tudo que lhe dará todos os dados relacionados a um único paciente.
Qual é a classificação padrão ao procurar recursos no serviço FHIR?
Oferecemos suporte à classificação por campos string e dateTime no serviço FHIR. Para obter mais informações sobre outros parâmetros de pesquisa com suporte, consulte Visão geral da pesquisa FHIR.
O serviço FHIR suporta alguma operação terminológica?
Não, o serviço FHIR não suporta operações de terminologia hoje.
Quais são as diferenças entre os tipos de exclusão no serviço FHIR?
Há dois tipos básicos de exclusão suportados no serviço FHIR. Eles são Exclusão e Exclusão Condicional.
- Com Exclusão, você pode optar por fazer uma exclusão reversível (tipo mais comum) e ainda conseguir recuperar versões históricas do seu registro.
- Com a Exclusão Condicional, você pode passar critérios de pesquisa para excluir um recurso, um item de cada vez ou vários de cada vez.
- Se você passou o
hardDeleteparâmetro com Excluir ou Exclusão condicional, todos os registros e histórico serão excluídos e irrecuperáveis.
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. A resposta do código de status HTTP com 200 e OverallStatus como Íntegro em resposta significa que sua verificação de integridade foi bem-sucedida.
Em caso de erros, você pode receber uma resposta de erro com o código de status HTTP 404 (Não encontrado) ou código de status 500 (Erro interno do servidor) e informações detalhadas no corpo da resposta.
Próximas etapas
Neste artigo, você aprendeu as respostas para as perguntas frequentes sobre o serviço FHIR. Para ver as perguntas frequentes sobre o serviço FHIR na API do Azure para FHIR, consulte
FHIR® é uma marca registrada da HL7 e é usado com a permissão da HL7.