Begränsningar i Microsoft Fabric API för GraphQL

Den här artikeln beskriver de aktuella begränsningarna i Microsoft Fabric API för GraphQL.

Begränsningar

Aktuella allmänna produktbegränsningar för API för GraphQL i Microsoft Fabric visas i den här artikeln. Vi förbättrar ständigt API:et för GraphQL med nya funktioner. Mer information om framtiden för Microsoft Fabric finns i Fabric Roadmap.

• Alla datakällor som använder en SQL Analytics-slutpunkt för åtkomst stöder endast läsåtgärder mot den. Mutationer är till exempel inte tillgängliga för Lakehouses eller speglade databaser.

• Den aktuella standardsidans storlek är 100, vilket innebär att varje begäran returnerar högst 100 element i svaret. Om resultatuppsättningen är större än 100 itererar du genom resultat med hjälp av GraphQL-sidnumrering.

• Den maximala sidnumreringsstorleken är 100 000. Det innebär att det finns ett fast maximalt antal element som en begäran returnerar och som du kan iterera igenom. Om du behöver returnera fler än 100 000 element för ditt program kan du utfärda flera begäranden. Förstå att det här mönstret inte är vanligt i GraphQL.

• Den maximala svarsstorleken som vi stöder är 64 MB. Det innebär att alla API-begäranden med en svarsstorlek som är större än 64 MB returnerar ett fel. Om du vill kringgå den här begränsningen kan du antingen utfärda flera filtrerade begäranden.

• Begränsningar för lagrade procedurer (gäller för Azure SQL, SQL Database i Fabric och Data Warehouse):

  • Endast den första resultatuppsättningen som returneras av den lagrade proceduren används av API för GraphQL.
  • Endast de lagrade procedurer vars metadata för den första resultatuppsättningen som beskrivs av sys.dm_exec_describe_first_result_set stöds.
  • När en lagrad procedurparameter anges både i konfigurationsfilen och i URL-frågesträngen har parametern i URL-frågesträngen företräde.
  • Entiteter som backas upp av en lagrad procedur har inte alla funktioner som automatiskt tillhandahålls för entiteter som backas upp av tabeller eller vyer.
  • Lagrade procedurstödda entiteter stöder inte sidnumrering, ordning eller filtrering. Sådana entiteter stöder inte heller returnering av objekt som anges av primärnyckelvärden.

• Tidsgränsen för begäran är för närvarande 100 sekunder. Det innebär att om du utfärdar en begäran som genererar en datakällafråga och den tar längre tid än 100 sekunder att slutföra, kan din begäran misslyckas och leda till ett felmeddelande.

• Det maximala frågedjupet som stöds är 10. Frågedjup är kapslingsnivån för fält i en fråga, vilket kan påverka prestanda om det är för djupt på grund av potentiell rekursion och överdriven datahämtning.

Kända problem

Kända problem i API för GraphQL finns under avsnittet Microsoft Fabric kända problem.

Relaterat innehåll

• API för GraphQL: Översikt
• Anslut program till Fabric API för GraphQL
• API för Vanliga frågor och svar om GraphQL