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
- Rich tooling - Permite a utilização de um vasto conjunto de ferramentas de desenvolvimento
É uma maneira mais eficiente de os aplicativos se comunicarem com servidores e bancos de dados.
O que é a API Microsoft Fabric para GraphQL?
A API Microsoft Fabric para GraphQL é um serviço gerido que lhe permite criar uma API GraphQL em segundos.
Fontes de dados suportadas:
- Microsoft Fabric Data Warehouses
- Microsoft Fabric Lakehouses
- Bases de Dados Espelhadas do Microsoft Fabric
- Bases de Dados SQL Microsoft Fabric
- Azure SQL Databases
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 através dos endpoints SQL Analytics são de leitura apenas, suportando assim 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 da aplicação cliente GraphQL requer acesso à fonte de dados para realizar consultas ou mutações?
Microsoft Entra ID autenticação: API para GraphQL requer que as aplicações utilizem 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:
- A aplicação registada no Microsoft Entra requer permissões GraphQLApi.Execute.All para o Power BI service. Para mais informações, consulte Criar uma aplicação Microsoft Entra em Azure.
Configuração Single sign-on (SSO): Se a API estiver configurada para usar SSO, o utilizador autenticado ou 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: Alternativamente, atribua o utilizador ou o principal do serviço como membro do espaço de trabalho com um papel de contribuidor onde estão localizados tanto a API quanto os itens da fonte de dados. Isto dá o acesso necessário a ambos os itens a partir de um único local. Para mais informações, consulte Conceder acesso aos utilizadores aos espaços de trabalho.
Configuração de credenciais guardadas: Se a API estiver configurada para usar credenciais guardadas, o utilizador ou principal do serviço autenticado só precisa de access à API (selecione a opção Executar Consultas e Mutações ao adicionar permissões de access diretas à 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 posso abrir um ticket de suporte para uma API GraphQL?
Para obter ajuda de Microsoft Support em qualquer questão relacionada com a API Fabric para GraphQL, visite o nosso site de suporte Fabric e escolha a opção Engenharia de Dados.
API do GraphQL tem suporte para Private Link?
A API para GraphQL suporta apenas Tenant Level Private Link neste 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. Também pode contactar-nos através do Microsoft Fabric Suporte para quaisquer dúvidas ou preocupações específicas.