Partilhar via

Limitações da API do Microsoft Fabric para GraphQL

As limitações gerais atuais do produto para API for GraphQL no Microsoft Fabric estão listadas neste artigo. Estamos continuamente a melhorar a API do GraphQL com novas funcionalidades. Para obter mais informações sobre o futuro do Microsoft Fabric, consulte Fabric Roadmap.

Quem precisa de compreender as limitações

Compreender as limitações da API do GraphQL é crucial para:

  • Desenvolvedores de aplicações que desenham aplicações que funcionam dentro das restrições da API Fabric GraphQL
  • Engenheiros de dados planeando estratégias de exposição de dados e a compreender os limites das plataformas
  • Arquitetos de soluções definem soluções baseadas em Fabric e definem expectativas técnicas adequadas
  • Contribuidores do Fabric Workspace a resolver problemas e implementar soluções alternativas para limitações atuais
  • Gestores de projeto a comunicarem as restrições da plataforma Fabric às partes interessadas durante o planeamento do projeto

Reveja estas limitações ao planear implementações da API GraphQL ou ao resolver comportamentos inesperados da API.

Operações de fonte de dados

As fontes de dados do endpoint SQL Analytics suportam apenas operações de leitura. Fontes de dados acedidas através de endpoints SQL Analytics (como Lakehouses e bases de dados espelhadas) não suportam mutações. Pode consultar dados, mas não pode criar, atualizar ou eliminar registos através da API GraphQL.

Limites de tamanho e desempenho

A tabela seguinte resume o tamanho da chave, a paginação e as limitações de desempenho:

Tipo de limite Valor Description Solução
Tamanho de página padrão 100 itens Itens máximos devolvidos por requisição por padrão Use a paginação GraphQL para iterar por conjuntos de resultados maiores
Tamanho máximo de paginação 100.000 itens Total máximo de itens que podem ser recuperados através de paginação Emita múltiplos pedidos filtrados se precisar de mais de 100 mil itens (padrão pouco comum no GraphQL)
Tamanho máximo da resposta 64 MB Tamanho máximo da carga útil de resposta de API Emitir múltiplos pedidos filtrados para recuperar dados em blocos mais pequenos
Tempo limite da requisição 100 segundos Tempo máximo de execução para um único pedido Otimizar consultas ou dividir operações complexas em pedidos mais pequenos
Profundidade máxima de consulta 10 níveis Nível máximo de aninhamento dos campos numa consulta Reduzir o aninhamento de consultas para evitar problemas de desempenho devido ao excesso de extração de dados

Limitações dos procedimentos armazenados

Os procedimentos armazenados em Azure SQL, SQL Database no Fabric e Data Warehouses têm restrições específicas:

  • Tratamento do conjunto de resultados: Apenas o primeiro conjunto de resultados devolvido pelo procedimento armazenado é utilizado. Não são suportados conjuntos de resultados múltiplos.
  • Requisitos de metadados: Apenas são suportados procedimentos armazenados cujos metadados do primeiro conjunto de resultados podem ser descritos por sys.dm_exec_describe_first_result_set.
  • Precedência de parâmetros: Quando um parâmetro de procedimento armazenado é especificado tanto no ficheiro de configuração como na cadeia de consulta URL, o valor da cadeia de consulta URL tem precedência.
  • Funcionalidades limitadas do GraphQL: Entidades suportadas por procedimentos armazenados têm capacidades reduzidas em comparação com entidades com tabelas ou visualizações:
    • Sem suporte para paginação
    • Sem ordenação ou filtragem
    • Sem consultas baseadas em chaves primárias

Problemas conhecidos

Para problemas conhecidos na API para GraphQL, visite Problemas Conhecidos do Microsoft Fabric.

Conteúdo relacionado

  • Last updated on