Encontre respostas para perguntas frequentes sobre a API do Fabric para o GraphQL.
O que é o GraphQL?
GraphQL é uma linguagem de consulta software livre para APIs e um runtime para atender a essas consultas usando os dados existentes. O GraphQL fornece uma descrição completa e compreensível dos dados na API, com um sistema fortemente baseado em tipos, proporciona aos clientes a capacidade de solicitar exatamente o que precisam e nada mais, facilita a evolução das APIs ao longo do tempo e permite o uso de ferramentas avançadas para desenvolvedores.
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. A API do Fabric para GraphQL está atualmente em preview.
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 de Data Warehouses, uma chave primária precisa ser definida para que as 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 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 o Microsoft Entra para fazer 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 Item.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 logon único (SSO), o usuário autenticado ou a entidade de serviço no aplicativo que chama a API GraphQL exigirá acesso à API 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 entidade de serviço como um membro do espaço de trabalho com uma função de colaborador, onde tanto a API quanto os itens da fonte de dados estão localizados, o que fornecerá o acesso necessário a ambos os itens em um único lugar. 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 amostra para entidades de usuário e entidades de serviço em 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.
Quais regiões ainda não oferecem suporte à API para GraphQL?
A API para GraphQL não é suportada atualmente na região Oeste dos EUA 3.