Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
As limitações gerais atuais do produto para a API para GraphQL no Microsoft Fabric estão listadas neste artigo. Estamos melhorando continuamente a API para GraphQL com novos recursos. Para obter mais informações sobre o futuro do Microsoft Fabric, consulte Fabric Roadmap.
Quem precisa entender as limitações
Entender as limitações da API do GraphQL é crucial para:
- Desenvolvedores de aplicativos que projetam aplicativos que funcionam dentro das restrições da API do GraphQL do Fabric
- Engenheiros de dados planejando estratégias de exposição de dados e entendendo os limites da plataforma
- Arquitetos de soluções que definem o escopo de soluções baseadas em Fabric e estabelecem as expectativas técnicas apropriadas
- Colaboradores do workspace do Fabric solucionando problemas e implementando soluções alternativas para limitações atuais
- Gerentes de projeto comunicando restrições da plataforma Fabric aos stakeholders durante o planejamento do projeto
Examine essas limitações ao planejar implementações da API do GraphQL ou solucionar problemas de comportamento inesperado da API.
Operações de fonte de dados
As fontes de dados do Endpoint de Análise de SQL somente dão suporte a operações de leitura. As fontes de dados acessadas por meio de endpoints de SQL Analytics (como Lakehouses e bancos de dados espelhados) não suportam mutações. Você pode consultar dados, mas não pode criar, atualizar ou excluir registros por meio da API do GraphQL.
Limites de tamanho e desempenho
A tabela a seguir resume o tamanho da chave, a paginação e as restrições de desempenho:
| Tipo de limite | Value | Description | Solução Alternativa |
|---|---|---|---|
| Tamanho da página padrão | 100 itens | Máximo de itens retornados por solicitação por padrão | Use a paginação do GraphQL para iterar através de conjuntos de resultados maiores |
| Tamanho máximo de paginação | 100.000 itens | Máximo de itens totais que podem ser recuperados por meio de paginação | Emita várias solicitações filtradas se precisar de mais de 100 mil itens (padrão incomum no GraphQL) |
| Tamanho máximo da resposta | 64 MB | Tamanho máximo da carga da resposta da API | Emitir várias solicitações filtradas para recuperar dados em partes menores |
| Tempo limite da solicitação | 100 segundos | Tempo máximo de execução para uma única solicitação | Otimizar consultas ou interromper operações complexas em solicitações menores |
| Profundidade máxima da consulta | 10 níveis | Nível máximo de aninhamento de campos em uma consulta | Reduza o aninhamento de consultas para evitar problemas de desempenho causados pela consulta excessiva de dados. |
Limitações de procedimentos armazenados
Os procedimentos armazenados no SQL do Azure, no Banco de Dados SQL no Fabric e nos Data Warehouses têm restrições específicas:
- Manipulação do conjunto de resultados: somente o primeiro conjunto de resultados retornado pelo procedimento armazenado é usado. Não há suporte para vários conjuntos de resultados.
-
Requisitos de metadados: há suporte apenas para procedimentos armazenados cujos metadados do primeiro conjunto de resultados podem ser descritos por
sys.dm_exec_describe_first_result_set. - Precedência de parâmetro: quando um parâmetro de procedimento armazenado é especificado no arquivo de configuração e na cadeia de caracteres de consulta de URL, o valor da cadeia de caracteres de consulta de URL tem precedência.
-
Recursos limitados do GraphQL: entidades apoiadas por procedimentos armazenados têm recursos reduzidos em comparação com entidades com suporte de tabela ou exibição:
- Sem suporte para paginação
- Nenhuma ordenação ou filtragem
- Nenhuma consulta baseada em chave primária
Problemas conhecidos
Para conhecer os problemas conhecidos na API para GraphQL, visite Problemas Conhecidos do Microsoft Fabric.