Compartilhar via

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 a API para 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 aproveite um Ponto de Extremidade de Análise do SQL para acesso oferece suporte apenas às operações de leitura. Por exemplo, as mutações não estão disponíveis para lakehouses ou bancos de dados espelhados.

  • O tamanho da página padrão atual é 100, o que significa que cada solicitação retornará no máximo 100 elementos na resposta. Se o conjunto de resultados for maior que 100, itere pelos resultados usando aPaginaçã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 100 mil elementos para seu aplicativo, emita várias solicitações. Entenda que esse padrão não é comum no GraphQL.

  • O maior tamanho de resposta que suportamos é de 64 MB. 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 SQL do Azure, ao Banco de Dados SQL no Fabric e aos Data Warehouses):

    • Somente o primeiro conjunto de resultados retornado pelo procedimento armazenado é usado pela API para GraphQL.
    • Somente os procedimentos armazenados, cujos metadados do primeiro conjunto de resultados são descritos por sys.dm_exec_describe_first_result_set, têm suporte.
    • 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 baseadas em um procedimento armazenado não têm todos os recursos fornecidos automaticamente para entidades baseadas em tabelas ou visões.
    • Entidades baseadas em procedimentos armazenados não oferecem suporte a paginação, ordenação ou filtragem. Essas entidades também não dão suporte ao retorno de itens especificados por valores de chave primária.

  • O tempo limite da solicitação atualmente é de 100 segundos. Isso significa que, se você emitir uma solicitação que gere uma consulta de fonte de dados que leve mais de 100 segundos para ser concluída, sua solicitação poderá falhar.

  • A profundidade máxima de consulta com suporte é 10. A profundidade da consulta é o nível de aninhamento de campos em uma consulta, o que pode afetar o desempenho se for muito profundo devido à possível recursão e à busca excessiva de dados.

Problemas conhecidos

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

Conteúdo relacionado