Del via

Begrensninger for Microsoft Fabric API for GraphQL

Denne artikkelen beskriver gjeldende begrensninger i Microsoft Fabric API for GraphQL.

Begrensninger

Gjeldende generelle produktbegrensninger for API for GraphQL i Microsoft Fabric er oppført i denne artikkelen. Vi forbedrer stadig API-en for GraphQL med nye funksjoner. Hvis du vil ha mer informasjon om fremtiden for Microsoft Fabric, kan du se Fabric Roadmap.

  • Alle datakilder som benytter et SQL Analytics-endepunkt for tilgang, støtter bare leseoperasjoner mot det. Mutasjoner er for eksempel ikke tilgjengelige for Lakehouses eller speilvendte databaser.

  • Gjeldende standard sidestørrelse er 100, noe som betyr at hver forespørsel returnerer maksimalt 100 elementer i svaret. Hvis resultatsettet er større enn 100, går du gjennom resultatene ved hjelp av GraphQL-paginering.

  • Den maksimale pagineringsstørrelsen er 100 000. Dette betyr at det er et fast maksimalt antall elementer som en forespørsel vil returnere, og at du kan gå gjennom. Hvis du trenger å returnere mer enn 100 000 elementer for programmet, kan du utstede flere forespørsler. Forstå at dette mønsteret ikke er vanlig i GraphQL.

  • Den maksimale svarstørrelsen vi støtter, er 64 MB. Det betyr at alle API-forespørsler med en svarstørrelse større enn 64 MB returnerer en feil. Hvis du vil omgå denne begrensningen, kan du enten utstede flere filtrerte forespørsler.

  • Begrensninger for lagrede prosedyrer (gjelder for Azure SQL, SQL Database i Fabric og Data Warehouses):

    • Bare det første resultatsettet som returneres av den lagrede prosedyren, brukes av API for GraphQL.
    • Bare de lagrede prosedyrene med metadata for det første resultatsettet som beskrives av sys.dm_exec_describe_first_result_set, støttes.
    • Når en lagret prosedyreparameter er angitt både i konfigurasjonsfilen og i url-spørringsstrengen, har parameteren i url-spørringsstrengen prioritet.
    • Enheter som støttes av en lagret prosedyre, har ikke alle funksjonene som automatisk er angitt for enheter støttet av tabeller eller visninger.
    • Lagrede prosedyrestøttede enheter støtter ikke paginering, bestilling eller filtrering. Slike enheter støtter heller ikke returelementer som er angitt av primærnøkkelverdier.

  • Tidsavbruddet for forespørselen er for øyeblikket 100 sekunder. Dette betyr at hvis du utsteder en forespørsel som genererer en datakildespørring som tar mer enn 100 sekunder å fullføre, kan forespørselen mislykkes og feile.

  • Den maksimale spørringsdybden som støttes, er 10. Spørringsdybde er nestenivået for felt i en spørring, noe som kan påvirke ytelsen hvis den er for dyp på grunn av potensiell rekursjon og overdreven datahenting.

Kjente problemer

Hvis du vil ha kjente problemer i API for GraphQL, kan du gå til Kjente problemer med Microsoft Fabric.

Relatert innhold

  • Last updated on