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. Ele usa um sistema de tipo forte para descrever claramente os dados disponíveis, reduz a busca excessiva permitindo solicitações precisas, facilita as atualizações de API sem quebrar o código existente e permite o uso de um amplo conjunto de ferramentas de desenvolvedor. É 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 GraphQL em segundos para acessar dados de suas fontes de dados, como Microsoft Fabric Data Warehouses, Microsoft Fabric Lakehouses, Microsoft Fabric Mirrored Databases, Microsoft Fabric SQL Databases e SQL do Azure Databases. 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. No caso dos 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. O Fabric gera resolvedores automaticamente sempre que você anexa uma nova fonte de dados ou seleciona novos objetos a serem expostos de uma fonte de dados existente. Atualmente, não é possível personalizar resolvedores. 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?
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 adequadamente para executar chamadas de API no Fabric. 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. Além do Microsoft Entra, se a API estiver configurada para usar o SSO (logon único), o usuário autenticado ou a entidade de serviço no aplicativo que chama a API do GraphQL exigirá acesso à API do GraphQL e à fonte de dados. Mais especificamente, permissão Executar consultas e mutações na API GraphQL e acesso de leitura ou gravação necessário na fonte de dados escolhida. Outra opção é ter o usuário ou a entidade de serviço como membro do workspace com uma função de colaborador em que os itens da API e da fonte de dados estão localizados, o que fornece o acesso necessário a ambos os itens de um único local. Para obter mais informações, consulte Conceder aos usuários acesso a espaços de trabalho. Como alternativa, se a API estiver configurada para usar credenciais salvas, o usuário autenticado ou a entidade de serviço só precisará ter acesso à API (selecione executar consultas e mutações opção ao adicionar permissões de acesso direto à API). 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. No entanto, estamos planejando dar suporte a esse recurso no futuro e forneceremos atualizações conforme elas estiverem disponíveis.
Habilitei o Link Privado para meu locatário do Fabric. Por que meus itens do GraphQL não estão funcionando?
Se a configuração de locatário "Bloquear acesso à Internet pública" estiver habilitada (ou seja, o acesso público será desabilitado), quaisquer artefatos ou itens sem suporte serão desabilitados automaticamente, incluindo a API para GraphQL. Isso significa que os itens criados anteriormente não podem ser acessados nem novos podem ser criados. A única maneira de acessar esses itens é permitir o acesso público.
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. Primeiro, a primeira solicitação poderá demorar mais se uma fonte de dados precisar ser aquecida se estiver fria. 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. O segundo motivo é que a primeira solicitação para um ponto de extremidade da API para GraphQL pode levar mais tempo porque o sistema precisa carregar seu esquema e configuração para estar pronto para aceitar solicitações. Esse é um custo único e 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.