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 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 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 Integridade do Azure.
Serviço FHIR: o básico
O que é o FHIR?
O Fast Healthcare Interoperability Resources (FHIR) é um padrão de interoperabilidade destinado a permitir a troca de dados de saúde entre diferentes sistemas de saúde. 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 (Padrão para Uso de Avaliação 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 Integridade 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 e ao provedor de identidade de terceiros que oferece suporte ao OpenID Connect.
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 aos 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 Integridade do Azure?
A API do Azure para FHIR foi nosso produto inicial em disponibilidade geral e 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 Integridade do Azure, serviço FHIR.
| Funcionalidades | API do Azure para FHIR | Serviços de Dados de Saúde do Azure |
|---|---|---|
| Entrada de dados | Ferramentas disponíveis no software de código aberto | $import operação. Para obter informações, visite Operação de importação |
| Dimensionamento automático | Com suporte mediante solicitação e sujeito a cobrança | Dimensionamento automático ativado 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 |
| Converter dados | Dá suporte à habilitaçã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 dos negócios | Com suporte: • DR entre regiões (recuperação de desastres) |
Com suporte: • PITR (recuperação pontual) • Suporte à zona de disponibilidade |
Por padrão, cada instância FHIR dos Serviços de Dados de Integridade do Azure é limitada à capacidade de armazenamento de 4 TB. Para provisionar uma instância FHIR com capacidade de armazenamento superior a 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 Integridade do Azure e o servidor FHIR de software livre?
O serviço FHIR nos Serviços de Dados de Saúde do Azure é uma versão hospedada e gerenciada do Microsoft FHIR Server para Azure de software livre. 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 Integridade do Azure estão disponíveis. Você pode ver as regiões com suporte na página Produtos por região .
Onde posso ver o que está sendo liberado 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á lançado para o serviço gerenciado, você pode examinar a página de versões do servidor FHIR de software livre. Trabalhamos para marcar itens com os Serviços de Dados de Integridade do Azure se eles forem lançados no serviço gerenciado e estiverem disponíveis duas semanas depois de estarem na página de lançamento de software livre. 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 instrução de capacidade para o serviço FHIR e na 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 exata do FHIR exposta na instrução de funcionalidade na fhirVersion propriedade (URL/metadados do 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 a URL do meu serviço FHIR?
Não. Não é possível alterar a URL do serviço FHIR.
Quais são os limites associados ao serviço FHIR nos Serviços de Dados de Integridade do Azure?
Consulte a seção "Limites de serviço" em Limites de serviço FHIR do Azure
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 on FHIR, você pode garantir que seu aplicativo possa ser acessado e usado por muitos sistemas diferentes. Para obter mais informações sobre o SMART, consulte SMART Health IT.
O serviço FHIR é compatível com SMART no FHIR?
Sim, o recurso SMART on FHIR é suportado usando amostras AHDS. Isso é conhecido como SMART no FHIR (aprimorado). 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 a documentação do SMART on 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.
Há suporte para extensões no serviço FHIR?
Sim. Permitimos que você carregue qualquer dado JSON FHIR válido 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 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 1.000 registros serão exibidos.
Posso postar um pacote no serviço FHIR?
Atualmente, oferecemos suporte à postagem de pacotes em lote e à postagem 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 obtém todos os dados relacionados a um único paciente.
O serviço FHIR dá suporte a alguma operação de terminologia?
Não, o serviço FHIR atualmente não dá suporte a operações de terminologia.
Usando o serviço FHIR
Posso realizar verificações de integridade 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 Healthy significa que sua verificação de integridade foi bem-sucedida.
Se houver erros, você poderá 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óximas etapas
Neste artigo, você aprendeu as respostas para as perguntas mais frequentes sobre o serviço FHIR. Para ver as perguntas frequentes sobre o serviço FHIR na API do Azure para FHIR, confira
Observação
FHIR® é uma marca registrada da HL7 e é usado com a permissão da HL7.