Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
De aktuelle generelle produktbegrænsninger for API til GraphQL i Microsoft Fabric er angivet i denne artikel. Vi forbedrer løbende API'et for GraphQL med nye funktioner. Du kan få flere oplysninger om fremtiden for Microsoft Fabric under Fabric Roadmap.
Hvem har brug for at forstå begrænsninger
Forståelse af GraphQL API's begrænsninger er afgørende for:
- Applikationsudviklere , der designer applikationer, der arbejder inden for Fabric GraphQL API-begrænsninger
- Dataingeniører , der planlægger strategier for dataeksponering og forstår platformgrænser
- Løsningsarkitekter, der afgrænser Fabric-baserede løsninger og fastsætter passende tekniske forventninger
- Fabric workspace-bidragydere til fejlfinding og implementering af løsninger på nuværende begrænsninger
- Projektledere kommunikerer Fabric-platformens begrænsninger til interessenter under projektplanlægning
Gennemgå disse begrænsninger, når du planlægger GraphQL API-implementeringer eller fejlsøger uventet API-adfærd.
Datakildeoperationer
SQL Analytics Endpoint-datakilder understøtter kun læseoperationer. Datakilder, der tilgås via SQL Analytics Endpoints (såsom Lakehouses og spejlede databaser), understøtter ikke mutationer. Du kan forespørge data, men kan ikke oprette, opdatere eller slette poster via GraphQL API'en.
Størrelses- og ydelsesgrænser
Følgende tabel opsummerer nøglestørrelse, paginering og ydeevnebegrænsninger:
| Grænsetype | Værdi | Beskrivelse | Løsning |
|---|---|---|---|
| Standard sidestørrelse | 100 genstande | Maksimalt antal genstande, der returneres pr. anmodning som standard. | Brug GraphQL-paginering til at iterere gennem større resultatsæt |
| Maksimal pagineringsstørrelse | 100.000 genstande | Maksimalt samlede elementer, der kan hentes via paginering | Udsend flere filtrerede anmodninger, hvis du har brug for mere end 100.000 elementer (usædvanligt mønster i GraphQL) |
| Maksimal responsstørrelse | 64 MB | Maksimal størrelse af API-responspayload | Udsend flere filtrerede anmodninger om at hente data i mindre bidder |
| Anmodning om timeout | 100 sekunder | Maksimal eksekveringstid for en enkelt anmodning | Optimer forespørgsler eller opdel komplekse operationer i mindre forespørgsler |
| Maksimal forespørgselsdybde | 10 niveauer | Maksimal indlejringsniveau af felter i en forespørgsel | Reducer forespørgselsindlejring for at undgå performanceproblemer fra overdreven datahentning |
Begrænsninger for lagrede procedurer
Lagrede procedurer i Azure SQL, SQL Database in Fabric og Data Warehouses har specifikke begrænsninger:
- Håndtering af resultatmængder: Kun det første resultatsæt, der returneres af den gemte procedure, anvendes. Flere resultatsæt understøttes ikke.
-
Metadatakrav: Kun lagrede procedurer, hvis metadata for første resultatsæt kan beskrives af
sys.dm_exec_describe_first_result_set, understøttes. - Parameterprioritet: Når en stored procedure-parameter er angivet både i konfigurationsfilen og URL-forespørgselsstrengen, har URL-forespørgselsstrengens værdi forrang.
-
Begrænsede GraphQL-funktioner: Entiteter understøttet af lagrede procedurer har reducerede kapaciteter sammenlignet med tabel- eller visningsbaserede enheder:
- Ingen pagineringsunderstøttelse
- Ingen rækkefølge eller filtrering
- Ingen primærnøglebaserede opslag
Kendte problemer
Du kan finde kendte problemer i API til GraphQL ved at gå til Kendte problemer i Microsoft Fabric.