Limitações da API do Microsoft Fabric para GraphQL
Este artigo detalha as limitações atuais na API do Microsoft Fabric para GraphQL.
Limitações
As limitações gerais atuais do produto para API for GraphQL no Microsoft Fabric estão listadas neste artigo. Estamos constantemente melhorando a API para GraphQL com novos recursos. Para obter mais informações sobre o futuro do Microsoft Fabric, consulte Fabric Roadmap.
- Qualquer fonte de dados que utilize um Endpoint de SQL Analytics para acesso apenas suporta operações de leitura. Por exemplo, as mutações não estão disponíveis para Lakehouses ou bancos de dados espelhados.
- O tamanho de página padrão atual é 100, o que significa que cada solicitação retornará um máximo de 100 elementos na resposta. Se o conjunto de resultados for maior que 100, percorra os resultados usando a paginação do GraphQL .
- O tamanho máximo de paginação é 100.000. Isso significa que há um número máximo fixo de elementos que uma solicitação retornará e você poderá iterar. Se você precisar retornar mais de 100K elementos para seu aplicativo, emita várias solicitações. Entenda que esse padrão não é comum no GraphQL.
- O tamanho máximo de resposta que suportamos é de 64MB. Isso significa que qualquer solicitação de API com um tamanho de resposta maior que 64 MB retorna um erro. Para contornar essa limitação, você pode emitir várias solicitações filtradas.
- Limitações para procedimentos armazenados (aplica-se ao Azure SQL, SQL Database no Fabric e Data Warehouses):
- Somente o primeiro conjunto de resultados retornado pelo procedimento armazenado é usado pela API para GraphQL.
- Apenas os procedimentos armazenados cujos metadados sobre o primeiro conjunto de resultados, descritos por sys.dm_exec_describe_first_result_set, são suportados.
- Quando um parâmetro de procedimento armazenado é especificado no arquivo de configuração e na cadeia de caracteres de consulta de URL, o parâmetro na cadeia de caracteres de consulta de URL tem precedência.
- As entidades apoiadas por um procedimento armazenado não têm todos os recursos fornecidos automaticamente para entidades apoiadas por tabelas ou vistas.
- As entidades suportadas por procedimentos armazenados não suportam paginação, ordenação ou filtragem. Essas entidades também não oferecem suporte ao retorno de itens especificados por valores de chave primária.
- Atualmente, o tempo limite da solicitação é de 100 segundos. Isso significa que, se você emitir uma solicitação que gera uma consulta de fonte de dados que leva mais de 100 segundos para ser concluída, sua solicitação poderá falhar e cometer erros.
Problemas conhecidos
Para problemas conhecidos na API para GraphQL, visite Problemas Conhecidos do Microsoft Fabric.