Not
Åtkomst till denna sida kräver auktorisation. Du kan prova att logga in eller byta katalog.
Åtkomst till denna sida kräver auktorisation. Du kan prova att byta katalog.
Aktuella allmänna produktbegränsningar för API för GraphQL i Microsoft Fabric visas i den här artikeln. Vi förbättrar api:et för GraphQL kontinuerligt med nya funktioner. Mer information om framtiden för Microsoft Fabric finns i Fabric Roadmap.
Vem behöver förstå begränsningar
Det är viktigt att förstå graphQL API-begränsningar för:
- Programutvecklare som utformar applikationer som fungerar inom begränsningar för Fabric GraphQL API
- Datatekniker planerar strategier för dataexponering och förstår plattformsgränser
- Lösningsarkitekter definierar omfattningen av Fabric-baserade lösningar och fastställer lämpliga tekniska förväntningar
- Medlemmar i Fabric-arbetsytan felsöker problem och implementerar tillfälliga lösningar för nuvarande begränsningar
- Projektledare som kommunicerar begränsningar av Fabric-plattformen till intressenter vid projektplanering
Granska dessa begränsningar när du planerar GraphQL API-implementeringar eller felsöker oväntat API-beteende.
Operationer för datakälla
SQL Analytics-slutpunktsdatakällor stöder endast läsåtgärder. Datakällor som nås via SQL Analytics-slutpunkter (till exempel Lakehouses och speglade databaser) stöder inte mutationer. Du kan fråga efter data men kan inte skapa, uppdatera eller ta bort poster via GraphQL-API:et.
Storleks- och prestandagränser
I följande tabell sammanfattas nyckelstorlek, sidnumrering och prestandabegränsningar:
| Gränstyp | Värde | Description | Övergångslösning |
|---|---|---|---|
| Standardstorlek för sidor | 100 objekt | Maximalt antal objekt som returneras per begäran som standard | Använda GraphQL-sidnumrering för att iterera genom större resultatuppsättningar |
| Maximal pagineringsstorlek | 100 000 objekt | Maximalt antal objekt som kan hämtas via sidnumrering | Utfärda flera filtrerade begäranden om du behöver fler än 100 000 objekt (ovanligt mönster i GraphQL) |
| Maximal svarsstorlek | 64 MB | Maximal storlek på API-svarsnyttolasten | Utfärda flera filtrerade begäranden för att hämta data i mindre segment |
| Begäran time-out | 100 sekunder | Maximal exekveringstid för en enskild begäran | Optimera frågor eller dela upp komplexa åtgärder i mindre begäranden |
| Maximalt frågedjup | 10 nivåer | Högsta kapslingsnivå för fält i en fråga | Minska frågekapsling för att undvika prestandaproblem vid överdriven datahämtning |
Begränsningar för lagrad procedur
Lagrade procedurer i Azure SQL, SQL Database i Fabric och Data Warehouse har specifika begränsningar:
- Hantering av resultatuppsättning: Endast den första resultatuppsättningen som returneras av den lagrade proceduren används. Flera resultatuppsättningar stöds inte.
-
Metadatakrav: Endast lagrade procedurer vars första resultatuppsättningsmetadata kan beskrivas av
sys.dm_exec_describe_first_result_setstöds. - Parameterföreträde: När en lagrad procedurparameter anges i både konfigurationsfilen och URL-frågesträngen har värdet för URL-frågesträngen företräde.
-
Begränsade GraphQL-funktioner: Entiteter som backas upp av lagrade procedurer har minskade funktioner jämfört med tabell- eller visningsbaserade entiteter:
- Inget sidnumreringsstöd
- Ingen ordning eller filtrering
- Inga primära nyckelbaserade sökningar
Kända problem
Kända problem i API för GraphQL finns under avsnittet Microsoft Fabric kända problem.