Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
Gjeldende generelle produktbegrensninger for API for GraphQL i Microsoft Fabric er oppført i denne artikkelen. Vi forbedrer kontinuerlig API-et for GraphQL med nye funksjoner. Hvis du vil ha mer informasjon om fremtiden for Microsoft Fabric, kan du se Fabric Roadmap.
Hvem trenger å forstå begrensninger
Å forstå begrensningene i GraphQL API er avgjørende for:
- Applikasjonsutviklere som designer applikasjoner som fungerer innenfor Fabric GraphQL API-begrensninger
- Dataingeniører planlegger strategier for dataeksponering og forstår plattformgrenser
- Løsningsarkitekter som avgrenser Fabric-baserte løsninger og setter passende tekniske forventninger
- Fabric workspace-bidragsytere som feilsøker problemer og implementerer løsninger for nåværende begrensninger
- Prosjektledere kommuniserer Fabric-plattformens begrensninger til interessenter under prosjektplanlegging
Gjennomgå disse begrensningene når du planlegger GraphQL API-implementeringer eller feilsøker uventet API-oppførsel.
Datakildeoperasjoner
SQL Analytics Endpoint-datakilder støtter kun leseoperasjoner. Datakilder som får tilgang til via SQL Analytics Endpoints (som Lakehouses og speilede databaser) støtter ikke mutasjoner. Du kan spørre data, men kan ikke opprette, oppdatere eller slette poster via GraphQL API.
Størrelses- og ytelsesgrenser
Følgende tabell oppsummerer nøkkelstørrelse, paginering og ytelsesbegrensninger:
| Grensetype | Verdi | Description | Løsning |
|---|---|---|---|
| Standard sidestørrelse | 100 gjenstander | Maksimalt antall elementer returnert per forespørsel som standard | Bruk GraphQL-paginering for å iterere gjennom større resultatsett |
| Maksimal pagineringsstørrelse | 100 000 gjenstander | Maksimalt antall elementer som kan hentes gjennom paginering | Send ut flere filtrerte forespørsler hvis du trenger mer enn 100 000 elementer (uvanlig mønster i GraphQL) |
| Maksimal responsstørrelse | 64 MB | Maksimal størrelse på API-responspayload | Send ut flere filtrerte forespørsler for å hente data i mindre biter |
| Tidsavbrudd for forespørsel | 100 sekunder | Maksimal utførelsestid for en enkelt forespørsel | Optimaliser spørringer eller del opp komplekse operasjoner i mindre forespørsler |
| Maksimal spørringsdybde | 10 nivåer | Maksimalt nestingsnivå av felt i en spørring | Redusere spørringsnesting for å unngå ytelsesproblemer fra overdreven datahenting |
Begrensninger for lagret prosedyre
Lagrede prosedyrer i Azure SQL, SQL Database in Fabric og Data Warehouses har spesifikke begrensninger:
- Håndtering av resultatsett: Kun det første resultatsettet som returneres av den lagrede prosedyren brukes. Flere resultatsett støttes ikke.
-
Metadatakrav: Kun lagrede prosedyrer hvor metadata fra første resultatsett kan beskrives av
sys.dm_exec_describe_first_result_set, støttes. - Parameterprioritet: Når en parameter for lagret prosedyre er spesifisert både i konfigurasjonsfilen og i URL-spørringsstrengen, får URL-spørringsstrengens verdi forrang.
-
Begrensede GraphQL-funksjoner: Entiteter støttet av lagrede prosedyrer har reduserte kapasiteter sammenlignet med tabell- eller visningsbaserte enheter:
- Ingen pagineringsstøtte
- Ingen rekkefølge eller filtrering
- Ingen oppslag basert på primærnøkkel
Kjente problemer
Hvis du vil ha kjente problemer i API for GraphQL, kan du gå til Kjente problemer med Microsoft Fabric.