Del via


Begrænsninger af Microsoft Fabric API til GraphQL

I denne artikel beskrives de aktuelle begrænsninger i Microsoft Fabric API til GraphQL.

Begrænsninger

De aktuelle generelle produktbegrænsninger for API til GraphQL i Microsoft Fabric er angivet i denne artikel. Vi forbedrer konstant API til GraphQL med nye funktioner. Du kan få flere oplysninger om fremtiden for Microsoft Fabric under Fabric Roadmap.

  • Alle datakilder, der udnytter et SQL Analytics-slutpunkt til adgang, understøtter kun læsehandlinger mod den. Mutationer er f.eks. ikke tilgængelige for Lakehouses eller spejlede databaser.
  • Den aktuelle standardsidestørrelse er 100, hvilket betyder, at hver anmodning returnerer maksimalt 100 elementer i svaret. Hvis dit resultatsæt er større end 100, gentages resultaterne ved hjælp af GraphQL-sideinddeling.
  • Den maksimale sideinddelingsstørrelse er 100.000. Det betyder, at der er et fast maksimalt antal elementer, som en anmodning returnerer, og du kan gentage. Hvis du har brug for at returnere mere end 100.000 elementer til dit program, skal du udstede flere anmodninger. Forstå, at dette mønster ikke er almindeligt i GraphQL.
  • Den maksimale svarstørrelse, vi understøtter, er 64 MB. Det betyder, at alle API-anmodninger med en svarstørrelse, der er større end 64 MB, returnerer en fejl. Du kan løse problemet med denne begrænsning ved enten at udstede flere filtrerede anmodninger.
  • Begrænsninger for lagrede procedurer (gælder for Azure SQL, SQL Database i Fabric og Data Warehouses):
    • Kun det første resultatsæt, der returneres af den lagrede procedure, bruges af API'en til GraphQL.
    • Kun de lagrede procedurer, hvis metadata for det første resultatsæt, der er beskrevet af sys.dm_exec_describe_first_result_set, understøttes.
    • Når der er angivet en parameter for en lagret procedure både i konfigurationsfilen og i URL-forespørgselsstrengen, har parameteren i URL-forespørgselsstrengen forrang.
    • Objekter, der understøttes af en lagret procedure, har ikke alle de funktioner, der automatisk leveres til objekter, der understøttes af tabeller eller visninger.
    • Enheder, der understøttes af lagrede procedurer, understøtter ikke sideinddeling, sortering eller filtrering. Sådanne enheder understøtter heller ikke returnering af elementer, der er angivet af primær nøgle-værdier.
  • Anmodningens timeout er i øjeblikket 100 sekunder. Det betyder, at hvis du udsteder en anmodning, der genererer en datakildeforespørgsel, der tager mere end 100 sekunder at fuldføre, kan din anmodning mislykkes og fejle.

Kendte problemer

Du kan finde kendte problemer i API til GraphQL ved at gå til Kendte problemer i Microsoft Fabric.