Omezení rozhraní Microsoft Fabric API pro GraphQL

Tento článek podrobně popisuje aktuální omezení v rozhraní Microsoft Fabric API pro GraphQL.

Omezení

Aktuální obecná omezení produktů pro rozhraní API pro GraphQL v Microsoft Fabric jsou uvedená v tomto článku. Rozhraní API pro GraphQL neustále vylepšujeme novými funkcemi. Další informace o budoucnosti Microsoft Fabric naleznete v tématu Plán infrastruktury.

• Jakýkoli zdroj dat, který k přístupu využívá „SQL Analytics Endpoint“, podporuje pouze operace čtení. Například mutace nejsou k dispozici pro jezera (Lakehouses) nebo zrcadlené databáze.

• Aktuální výchozí velikost stránky je 100, což znamená, že každý požadavek vrátí v odpovědi maximálně 100 prvků. Pokud sada vašich výsledků přesahuje 100, procházejte výsledky pomocí stránkování GraphQL .

• Maximální velikost stránkování je 100 000. To znamená, že existuje pevný maximální počet prvků, které požadavek vrátí a můžete iterovat. Pokud potřebujete vrátit více než 100 tisíc prvků pro vaši aplikaci, zadejte více požadavků. Mějte na vědomí, že tento model není v GraphQL běžný.

• Maximální velikost odpovědi, která podporujeme, je 64 MB. To znamená, že jakýkoli požadavek rozhraní API s velikostí odpovědi větší než 64 MB vrátí chybu. Pokud chcete toto omezení obejít, můžete vydat několik filtrovaných požadavků.

• Omezení uložených procedur (platí pro Azure SQL, SQL Database v systému Fabric a datové sklady):

  • Rozhraní API pro GraphQL používá pouze první sadu výsledků vrácenou uloženou procedurou.
  • Podporují se pouze uložené procedury, jejichž metadata pro první sadu výsledků popisuje sys.dm_exec_describe_first_result_set.
  • Pokud je parametr uložené procedury zadán jak v konfiguračním souboru, tak v řetězci dotazu adresy URL, má přednost parametr v řetězci dotazu adresy URL.
  • Entity zálohované uloženou procedurou nemají všechny možnosti, které automaticky poskytují entity zálohované tabulkami nebo zobrazeními.
  • Uložené entity zálohované procedurou nepodporují stránkování, řazení ani filtrování. Takové entity také nepodporují vracení položek určených hodnotami primárního klíče.

• Časový limit požadavku je aktuálně 100 sekund. To znamená, že pokud vydáte požadavek, který vygeneruje dotaz na zdroj dat, který trvá déle než 100 sekund, může dojít k selhání a chybě.

• Maximální podporovaná hloubka dotazu je 10. Hloubka dotazu je úroveň vnoření polí v dotazu, což může mít vliv na výkon, pokud je příliš hluboký kvůli potenciální rekurzi a nadměrnému načítání dat.

Známé problémy

Informace o známých problémech v rozhraní API pro GraphQL najdete v tématu známé problémy Microsoft Fabric.

Související obsah

• Přehled API pro GraphQL
• Připojení aplikací k rozhraní FABRIC API pro GraphQL
• API pro GraphQL – nejčastější dotazy