Encontre respostas para perguntas frequentes sobre a API de malha para o GraphQL.
O que é o GraphQL?
O GraphQL é uma linguagem de consulta de código aberto para APIs e um tempo de execução para preencher essas consultas com seus dados existentes. O GraphQL fornece uma descrição completa e compreensível dos dados em sua API com um sistema fortemente tipado, dá aos clientes o poder de pedir exatamente o que precisam e nada mais, facilita a evolução das APIs ao longo do tempo e permite poderosas ferramentas de desenvolvedor.
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 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 Azure SQL Databases. Ele fornece uma camada de API unificada para consultar e mutar dados dessas fontes de dados suportadas. A API de malha para GraphQL está atualmente em visualização.
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 por meio de pontos de extremidade do SQL Analytics são somente leitura, portanto, suportam apenas 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 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. A malha gera automaticamente resolvedores sempre que você anexa uma nova fonte de dados ou seleciona novos objetos a serem expostos a partir 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 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, consulte Criar um aplicativo 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 , a permissão Executar consultas e mutações na API do GraphQL e o acesso de leitura ou gravação necessário na fonte de dados de escolha de acordo. 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 os itens da API e da fonte de dados estão localizados, o que fornecerá 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 opção Executar consultas e mutações 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 usuário e entidades de serviço em Connect Applications.
Como faço para abrir um tíquete de suporte para API para GraphQL?
Para obter ajuda do Suporte da Microsoft em qualquer problema relacionado à API de malha para GraphQL, visite nosso site de Suporte de malha e escolha a opção Engenharia de dados.
Quais regiões ainda não são suportadas pela API para GraphQL?
A API para GraphQL não é suportada atualmente na região Oeste dos EUA 3.