Encontre respostas para perguntas frequentes sobre a API do Fabric para o GraphQL.
O que é o GraphQL?
O GraphQL é uma linguagem de consulta para APIs que permite que os aplicativos solicitem exatamente os dados necessários. Entre os principais benefícios estão:
- Sistema de tipos fortes – descreve claramente os dados disponíveis
- Busca precisa de dados – reduz a busca excessiva permitindo solicitações específicas
- Compatibilidade com versões anteriores – torna as atualizações de API mais fáceis sem quebrar o código existente
- Ferramentas avançadas – permite o uso de um amplo conjunto de ferramentas de desenvolvimento
É uma maneira mais eficiente de os aplicativos se comunicarem com servidores e bancos de dados.
O que é Microsoft Fabric API para GraphQL?
Microsoft Fabric API para GraphQL é um serviço gerenciado que permite criar uma API do GraphQL em segundos.
Fontes de dados com suporte:
- Microsoft Fabric Data Warehouses
- Microsoft Fabric Lakehouses
- Bancos de Dados Espelhados do Microsoft Fabric
- bancos de dados SQL Microsoft Fabric
- Bancos de dados Azure SQL
Ele fornece uma camada de API unificada para consultar e mudar dados dessas fontes de dados com suporte.
Quais operações do GraphQL são suportadas na API do Fabric para GraphQL?
Apenas consultas GraphQL (leitura) e mutações (gravação) são suportadas atualmente. As fontes de dados expostas por meio de endpoints do SQL Analytics são somente para leitura, portanto, suportam apenas consultas. Para Data Warehouses, uma chave primária precisa ser definida para que mutações sejam geradas automaticamente.
Como posso visualizar e editar resolvedores na API do Fabric para GraphQL?
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 resolvedores sempre que você anexa uma nova fonte de dados ou seleciona novos objetos a serem expostos de uma fonte de dados existente.
Personalização: Atualmente, não é possível personalizar resolvedores diretamente. Para a 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 do aplicativo cliente GraphQL requer acesso à origem de dados para executar consultas ou mutações?
Microsoft Entra ID authentication: API for GraphQL requer que os aplicativos usem Microsoft Entra ID para autenticação. Seu aplicativo cliente deve ser registrado e configurado para executar chamadas de API no Fabric.
Permissões necessárias:
- O aplicativo registrado no Microsoft Entra requer permissões GraphQLApi.Execute.All para o Power BI service. Para obter mais informações, consulte Criar um aplicativo do Microsoft Entra no Azure.
Configuração de Single sign-on (SSO): Se a API estiver configurada para usar SSO, o usuário autenticado ou principal de serviço exige acesso a ambos:
- A API do GraphQL (permissão Executar Consultas e Mutações )
- A fonte de dados (acesso de leitura ou gravação, conforme necessário)
Opção de acesso no nível do Espaço de Trabalho: Alternativamente, atribua o usuário ou principal de serviço como membro do espaço de trabalho com um papel de contribuidor onde estão localizados tanto os itens da API quanto da fonte de dados. Isso fornece o acesso necessário a ambos os itens de um único lugar. Para obter mais informações, consulte Conceder acesso aos usuários para áreas de trabalho.
A configuração de credenciais salvas: se a API estiver configurada para usar credenciais salvas, o usuário autenticado ou entidade de serviço só precisará de acesso à API (selecione Executar Consultas e Mutações ao adicionar permissões de acesso direto à API).
Exemplos: Você pode encontrar um exemplo de ponta a ponta com código de exemplo para entidades de segurança de usuário e entidades de serviço no Connect Applications.
Como eu abro um tíquete de suporte para a API GraphQL?
Para obter ajuda do Microsoft Support sobre qualquer problema relacionado à API do Fabric para GraphQL, visite nosso site de suporte Fabric e escolha a opção Data Engineering.
A API para GraphQL dá suporte a Private Link?
A API para GraphQL dá suporte apenas a Tenant Level Private Link neste momento.
Por que minha solicitação tem uma performance ruim quando a executo pela primeira vez, e depois tem uma boa performance em solicitações subsequentes?
Há dois motivos principais para esse comportamento de "início frio":
Aquecimento da fonte de dados:
- A primeira solicitação pode levar mais tempo se uma fonte de dados precisar ser aquecida de um estado frio
- Mesmo que a fonte de dados não esteja fria, a recuperação de dados poderá não ser tão eficiente na primeira vez que o GraphQL emitir uma consulta se a fonte de dados não tiver os dados necessários carregados na memória
Inicialização do endpoint da API:
- A primeira solicitação a um endpoint da API para GraphQL pode levar mais tempo porque o sistema precisa carregar seu esquema e configuração
- As solicitações subsequentes são mais rápidas porque o sistema já está aquecido e pronto para atender às suas solicitações
Você pode encontrar mais informações sobre as práticas recomendadas de desempenho.
Como posso fornecer comentários ou sugestões para a API para GraphQL?
Damos as boas-vindas aos seus comentários e sugestões! Você pode fornecer feedback por meio do Ideias do Fabric. Nossa equipe monitora ativamente os comentários e sugestões enviados por meio desta plataforma. Você também pode entrar em contato conosco por meio de Microsoft Fabric Support para quaisquer consultas ou preocupações específicas.