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 – habilita o uso de um amplo conjunto de ferramentas para desenvolvedores
É 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 API do Microsoft Fabric 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 do Microsoft Fabric
- Bancos de Dados SQL do Azure
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 pontos de extremidade do SQL Analytics são somente leitura, portanto, oferecem suporte apenas a 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 para o aplicativo cliente GraphQL requer acesso à fonte de dados para executar consultas ou mutações?
Autenticação da ID do Microsoft Entra: A API para GraphQL requer que os aplicativos usem a ID do Microsoft Entra 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 serviço do Power BI. Para obter mais informações, confira Criar um aplicativo do Microsoft Entra no Azure.
Configuração de SSO (Single Sign-On): Se a API estiver configurada para usar o SSO, o usuário autenticado ou o service principal 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 workspace: Como alternativa, atribua o usuário ou a entidade de serviço como um membro do workspace com uma função de colaborador em que os itens da API e da fonte de dados estão localizados. Isso fornece o acesso necessário a ambos os itens de um único lugar. Para obter mais informações, consulte Conceder aos usuários acesso a espaços de trabalho.
Configuração de credenciais salvas: Se a API estiver configurada para usar credenciais salvas, o usuário autenticado ou a entidade de serviço só precisará acessar a 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 abrir um tíquete de suporte para API para GraphQL?
Para obter ajuda do Suporte da Microsoft sobre qualquer problema relacionado à API do Fabric para GraphQL, visite nosso site de suporte do Fabric e escolha a opção Engenharia de dados.
A API para GraphQL dá suporte ao Link Privado?
A API para GraphQL não dá suporte ao Link Privado no momento.
Por que minha solicitação tem um desempenho ruim na primeira vez que a emita e, em seguida, tem um bom desempenho 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 comentários por meio de 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 suporte do Microsoft Fabric para consultas ou preocupações específicas.