Encontre respostas para perguntas frequentes sobre a API de malha para o GraphQL.
O que é o GraphQL?
O GraphQL é uma linguagem de consulta para APIs que permite que os aplicativos solicitem exatamente os dados de que precisam. Os principais benefícios incluem:
- Sistema de tipos forte - Descreve claramente os dados disponíveis
- Busca precisa de dados - Reduz o excesso de busca ao permitir pedidos específicos
- Compatibilidade retroativa - Facilita as atualizações da API sem quebrar o código existente
- Ferramentas ricas - Permite a utilização de um conjunto alargado de ferramentas para programadores
É uma maneira mais eficiente de os aplicativos se comunicarem com servidores e bancos de dados.
O que é a API do Microsoft Fabric para GraphQL?
A Microsoft Fabric API para GraphQL é um serviço gerido que lhe permite criar uma API GraphQL em segundos.
Fontes de dados suportadas:
- Armazéns de Dados Microsoft Fabric
- Microsoft Fabric Lakehouse
- Bases de Dados Espelhadas do Microsoft Fabric
- Bases de Dados SQL Microsoft Fabric
- Bases de Dados SQL do Azure
Ele fornece uma camada de API unificada para consultar e mutar dados dessas fontes de dados suportadas.
Quais operações do GraphQL são suportadas na API de malha para GraphQL?
Atualmente, apenas consultas GraphQL (leitura) e mutações (gravação) são suportadas. As fontes de dados expostas por meio de pontos de extremidade do SQL Analytics são somente leitura, portanto, suportam apenas consultas. Para os Data Warehouses, é necessário definir uma chave primária para que as mutações sejam geradas automaticamente.
Como posso visualizar e editar resolvedores na API de malha para GraphQL?
Os resolvedores são componentes do GraphQL que fornecem a lógica de negócios para resolver campos na API e executar operações com dados residentes nas fontes de dados.
Geração automática: O Fabric gera automaticamente resolvers sempre que anexa uma nova fonte de dados ou seleciona novos objetos a serem expostos a partir de uma fonte de dados existente.
Personalização: Atualmente, não é possível personalizar resolvers diretamente. Para lógica de negócios personalizada na API para GraphQL, você pode criar um procedimento armazenado na fonte de dados e expô-lo na API do GraphQL.
A API para o aplicativo cliente GraphQL requer acesso à fonte de dados para executar consultas ou mutações?
Autenticação Microsoft Entra ID: A API para GraphQL requer que as aplicações utilizem o Microsoft Entra ID para autenticação. A sua aplicação cliente deve estar registada e configurada para executar chamadas de API no Fabric.
Permissões obrigatórias:
- O aplicativo registrado no Microsoft Entra requer permissões GraphQLApi.Execute.All para o serviço do Power BI. Para obter mais informações, consulte Criar um aplicativo Microsoft Entra no Azure.
Configuração de login único (SSO): Se a API estiver configurada para usar SSO, o utilizador autenticado ou o principal do serviço requer acesso a ambos:
- A API GraphQL (Permissão de Executar Consultas e Mutações )
- A fonte de dados (acesso de leitura ou escrita conforme necessário)
Opção de acesso ao nível do espaço de trabalho: Em alternativa, atribuir o utilizador ou principal do serviço como membro do espaço de trabalho com um papel de contribuidor , onde se localizam tanto a API como os itens da fonte de dados. Isto dá o acesso necessário a ambos os itens a partir de um único local. Para obter mais informações, consulte Conceder aos usuários acesso a espaços de trabalho.
Configuração das credenciais guardadas: Se a API estiver configurada para usar credenciais guardadas, o utilizador autenticado ou principal do serviço só precisa de acesso à API (selecione a opção Executar Consultas e Mutações ao adicionar permissões de acesso direto à API).
Exemplos: Pode encontrar um exemplo completo com código de exemplo tanto para principais de usuário como para principais de serviço na Connect Applications.
Como faço para abrir um tíquete de suporte para API para GraphQL?
Para obter ajuda do Suporte da Microsoft em qualquer problema relacionado à API de malha para GraphQL, visite nosso site de Suporte de malha e escolha a opção Engenharia de dados.
A API para GraphQL suporta Private Link?
API para GraphQL não suporta Private Link no momento.
Porque é que o meu pedido tem um mau desempenho na primeira vez que o emito e, em seguida, um bom desempenho nos pedidos subsequentes?
Existem duas razões principais para este comportamento de "arranque a frio":
Aquecimento da fonte de dados:
- O primeiro pedido pode demorar mais tempo se uma fonte de dados precisar de ser aquecida a partir de um estado frio
- Mesmo que a fonte de dados não esteja fria, a recuperação de dados pode não ser tão eficiente na primeira vez que o GraphQL emite uma consulta se a fonte de dados não tiver os dados necessários carregados na memória
Inicialização do endpoint da API:
- O primeiro pedido a uma API para o endpoint GraphQL pode demorar mais porque o sistema precisa de carregar o seu esquema e configuração
- Pedidos subsequentes são mais rápidos porque o sistema já está pronto para atender aos seus pedidos
Você pode encontrar mais informações nas práticas recomendadas de desempenho.
Como posso fornecer feedback ou sugestões para a API para GraphQL?
Agradecemos os seus comentários e sugestões! Você pode fornecer feedback através do Fabric Ideas. A nossa equipa monitoriza ativamente os comentários e sugestões submetidos através desta plataforma. Você também pode entrar em contato conosco por meio de de Suporte do Microsoft Fabric para quaisquer dúvidas ou preocupações específicas.