Zdieľať cez

Obmedzenia rozhrania Microsoft Fabric API pre GraphQL

Aktuálne všeobecné obmedzenia produktu pre rozhranie API pre GraphQL v službe Microsoft Fabric sú uvedené v tomto článku. Neustále vylepšujeme API pre GraphQL o nové funkcie. Ďalšie informácie o budúcnosti služby Microsoft Fabric nájdete v téme plán služby Fabric.

Kto potrebuje rozumieť obmedzeniam

Pochopenie obmedzení GraphQL API je kľúčové pre:

  • Vývojári aplikácií navrhujú aplikácie, ktoré fungujú v rámci obmedzení Fabric GraphQL API
  • Dátoví inžinieri, ktorí plánujú stratégie expozície dátam a rozumejú hraniciam platforiem
  • Architekti riešení definujú riešenia založené na Fabric a stanovujú vhodné technické očakávania
  • Prispievatelia do pracovného priestoru fabric riešia problémy a implementujú obchádzky pre aktuálne obmedzenia
  • Projektoví manažéri komunikujúci obmedzenia platformy Fabric zainteresovaným stranám počas plánovania projektu

Tieto obmedzenia si preštudujte pri plánovaní implementácií GraphQL API alebo pri riešení neočakávaného správania API.

Operácie so zdrojom dát

Dátové zdroje SQL Analytics Endpoint podporujú iba operácie čítania. Dátové zdroje prístupné cez SQL Analytics Endpointy (ako Lakehouse a zrkadlené databázy) nepodporujú mutácie. Môžete dotazovať na dáta, ale nemôžete vytvárať, aktualizovať ani mazať záznamy cez GraphQL API.

Obmedzenia veľkosti a výkonu

Nasledujúca tabuľka zhrňuje veľkosť kľúča, stránkovanie a výkonnostné obmedzenia:

Typ limitu Hodnota Popis Alternatívne riešenie
Predvolená veľkosť stránky 100 položiek Maximálny počet položiek vrátených na požiadavku je predvolený Použite stránkovanie v GraphQL na prechod cez väčšie množiny výsledkov
Maximálna veľkosť stránkovania 100 000 položiek Maximálny celkový počet položiek, ktoré je možné získať stránkovaním Ak potrebujete viac ako 100 000 položiek, vydajte viacero filtrovaných požiadaviek (nezvyčajný vzorec v GraphQL)
Maximálna veľkosť odozvy 64 MB Maximálna veľkosť API odpovedného payloadu Vydávanie viacerých filtrovaných požiadaviek na získanie dát v menších blokoch
Časový limit požiadaviek 100 sekúnd Maximálny čas vykonania pre jednu požiadavku Optimalizujte dotazy alebo rozdeľte zložité operácie na menšie požiadavky
Maximálna hĺbka dotazu 10 úrovní Maximálna úroveň zanorenia polí v dotaze Znížiť vnorenie dotazov, aby sa predišlo problémom s výkonom spôsobeným nadmerným načítavaním dát

Obmedzenia uložených procedúr

Uložené procedúry v Azure SQL, SQL Database vo Fabric a dátových skladoch majú špecifické obmedzenia:

  • Spracovanie množín výsledkov: Používa sa iba prvá množina výsledkov vrátená uloženou procedúrou. Viaceré výsledkové sady nie sú podporované.
  • Požiadavky na metadáta: Podporované sú iba uložené procedúry, ktorých metadáta prvej výsledkovej sady môžu byť opísané .sys.dm_exec_describe_first_result_set
  • Priorita parametra: Keď je parameter uloženej procedúry špecifikovaný v konfiguračnom súbore aj v reťazci URL dotazu, hodnota reťazca URL dotazu má prednosť.
  • Obmedzené funkcie GraphQL: Entity podporované uloženými procedúrami majú znížené schopnosti v porovnaní s entitami podloženými tabuľkou alebo pohľadom:
    • Žiadna podpora stránkovania
    • Žiadne poradie ani filtrovanie
    • Žiadne vyhľadávania založené na primárnych kľúčoch

Známe problémy

Známe problémy v rozhraní API pre GraphQL nájdete známych problémov služby Microsoft Fabric.

Súvisiaci obsah

  • Last updated on