Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
De huidige algemene productbeperkingen voor API voor GraphQL in Microsoft Fabric worden in dit artikel vermeld. We verbeteren de API voor GraphQL voortdurend met nieuwe functies. Zie Fabric Roadmapvoor meer informatie over de toekomst van Microsoft Fabric.
Wie moet de beperkingen begrijpen
Inzicht in De beperkingen van GraphQL-API's is van cruciaal belang voor:
- Toepassingsontwikkelaars ontwerpen toepassingen die werken binnen beperkingen van de Fabric GraphQL-API
- Data engineers plannen strategieën voor gegevensblootstelling en begrijpen platformgrenzen
- Oplossingsarchitecten verkennen en definiëren op Fabric gebaseerde oplossingen en stellen de juiste technische verwachtingen in
- Bijdragers aan Fabric-werkruimten lossen problemen op en implementeren tijdelijke oplossingen voor huidige beperkingen.
- Projectmanagers die beperkingen van het Fabric-platform communiceren aan belanghebbenden tijdens de projectplanning
Bekijk deze beperkingen bij het plannen van GraphQL API-implementaties of het oplossen van problemen met onverwacht API-gedrag.
Bewerkingen voor gegevensbronnen
Gegevensbronnen van SQL Analytics-eindpunten ondersteunen alleen leesbewerkingen. Gegevensbronnen die toegankelijk zijn via SQL Analytics-eindpunten (zoals Lakehouses en gespiegelde databases), ondersteunen geen mutaties. U kunt query's uitvoeren op gegevens, maar geen records maken, bijwerken of verwijderen via de GraphQL-API.
Grootte- en prestatielimieten
De volgende tabel bevat een overzicht van de sleutelgrootte, paginering en prestatiebeperkingen:
| Limiettype | Waarde | Description | Tijdelijke maatregel |
|---|---|---|---|
| Standaardpaginaformaat | 100 artikelen | Maximum aantal items dat standaard per aanvraag wordt geretourneerd | GraphQL-paginering gebruiken om grotere resultatensets te doorlopen |
| Maximale pagineringsgrootte | 100.000 items | Maximumaantal items dat kan worden opgehaald via paginering | Meerdere gefilterde aanvragen uitgeven als u meer dan 100.000 items nodig hebt (ongebruikelijk patroon in GraphQL) |
| Maximale antwoordgrootte | 64 MB | Maximale grootte van de API-respons-payload | Meerdere gefilterde aanvragen uitgeven om gegevens op te halen in kleinere segmenten |
| Time-out van aanvraag | 100 seconden | Maximale uitvoeringstijd voor één aanvraag | Query's optimaliseren of complexe bewerkingen opsplitsen in kleinere aanvragen |
| Maximale querydiepte | 10 niveaus | Maximum aantal geneste velden in een query | Het nesten van query's verminderen om prestatieproblemen te voorkomen bij overmatig ophalen van gegevens |
Beperkingen voor opgeslagen procedures
Opgeslagen procedures in Azure SQL, SQL Database in Fabric en Data Warehouses hebben specifieke beperkingen:
- Verwerking van resultatensets: Alleen de eerste resultatenset die door de opgeslagen procedure wordt geretourneerd, wordt gebruikt. Meerdere resultatensets worden niet ondersteund.
-
Vereisten voor metagegevens: alleen opgeslagen procedures die door
sys.dm_exec_describe_first_result_setbeschreven kunnen worden waarvan de metagegevens van de eerste resultatenset worden ondersteund. - Parameterprioriteit: wanneer een opgeslagen procedureparameter is opgegeven in zowel het configuratiebestand als de URL-querytekenreeks, heeft de waarde van de URL-queryreeks voorrang.
-
Beperkte GraphQL-functies: entiteiten die worden ondersteund door opgeslagen procedures hebben beperkte mogelijkheden in vergelijking met entiteiten met een tabel of door weergave ondersteunde entiteiten:
- Geen ondersteuning voor paginering
- Geen volgorde of filteren
- Geen op primaire sleutels gebaseerde zoekacties
Bekende problemen
Voor bekende problemen in API voor GraphQL gaat u naar bekende problemen met Microsoft Fabric.