Delen via


Beperkingen van Microsoft Fabric-API voor GraphQL

In dit artikel worden de huidige beperkingen in de Microsoft Fabric-API voor GraphQL beschreven.

Beperkingen

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.

  • Elke gegevensbron die gebruikmaakt van een SQL Analytics-eindpunt voor toegang, ondersteunt alleen leesbewerkingen. Mutaties zijn bijvoorbeeld niet beschikbaar voor Lakehouses of gespiegelde databases.

  • Het huidige standaardpaginaformaat is 100, wat betekent dat elke aanvraag maximaal 100 elementen in het antwoord retourneert. Als uw resultatenset groter is dan 100, doorloopt u de resultaten met behulp van GraphQL-paginering.

  • De maximale pagineringsgrootte is 100.000. Dit betekent dat er een vast maximum aantal elementen is dat een aanvraag retourneert en dat u deze kunt herhalen. Als u meer dan 100.000 elementen voor uw toepassing wilt retourneren, moet u meerdere aanvragen uitgeven. Begrijp dat dit patroon niet gebruikelijk is in GraphQL.

  • De maximale antwoordgrootte die we ondersteunen, is 64 MB. Dat betekent dat elke API-aanvraag met een antwoordgrootte groter dan 64 MB een fout retourneert. Als u deze beperking wilt omzeilen, kunt u meerdere gefilterde aanvragen uitgeven.

  • Beperkingen voor opgeslagen procedures (van toepassing op Azure SQL, SQL Database in Fabric en datawarehouses):

    • Alleen de eerste resultatenset die door de opgeslagen procedure wordt geretourneerd, wordt gebruikt door API voor GraphQL.
    • Alleen de opgeslagen procedures waarvan de metagegevens voor de eerste resultatenset die door sys.dm_exec_describe_first_result_set worden beschreven, worden ondersteund.
    • Wanneer een opgeslagen procedureparameter zowel in het configuratiebestand als in de URL-querytekenreeks is opgegeven, heeft de parameter in de URL-queryreeks voorrang.
    • Entiteiten die worden ondersteund door een opgeslagen procedure, hebben niet alle mogelijkheden die automatisch worden geboden voor entiteiten die worden ondersteund door tabellen of weergaven.
    • Opgeslagen procedure ondersteunde entiteiten bieden geen ondersteuning voor paginering, volgorde of filtering. Dergelijke entiteiten bieden ook geen ondersteuning voor het retourneren van items die zijn gespecificeerd door primaire sleutelwaarden.
  • De time-out van de aanvraag is momenteel 100 seconden. Dit betekent dat als u een verzoek indient dat een gegevensbronquery genereert die langer dan 100 seconden duurt om te voltooien, uw verzoek mogelijk mislukt.

  • De maximale querydiepte die wordt ondersteund, is 10. De querydiepte is het nestniveau van velden in een query, wat van invloed kan zijn op de prestaties als deze te diep zijn vanwege mogelijke recursie en overmatig ophalen van gegevens.

Bekende problemen

Voor bekende problemen in API voor GraphQL gaat u naar bekende problemen met Microsoft Fabric.