Obmedzenia rozhrania Microsoft Fabric API pre GraphQL

V tomto článku sa uvádzajú aktuálne obmedzenia rozhrania Microsoft Fabric API pre GraphQL.

Obmedzenia

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

• Akýkoľvek zdroj údajov, ktorý využíva koncový bod služby SQL Analytics na prístup, podporuje iba operácie čítania. Napríklad mutácie nie sú k dispozícii pre Lakehouses alebo zrkadlové databázy.

• Aktuálna predvolená veľkosť strany je 100, čo znamená, že každá žiadosť vráti v odpovedi maximálne 100 prvkov. Ak je vaša množina výsledkov väčšia ako 100, iterujte v rámci výsledkov pomocou stránkovania GraphQL.

• Maximálna veľkosť stránkovania je 100 000. To znamená, že existuje pevne daný maximálny počet prvkov, ktoré žiadosť vráti, a vy budete môcť iterovať. Ak potrebujete pre aplikáciu vrátiť viac ako 100 000 prvkov, vytvorte viacero požiadaviek. Pochopte, že tento vzor nie je v jazyku GraphQL bežný.

• Maximálna veľkosť odpovede, ktoré podporujeme, je 64 MB. To znamená, že každá požiadavka rozhrania API s veľkosťou odpovede väčšou ako 64 MB vráti chybu. Ak chcete toto obmedzenie obísť, môžete buď vydať viacero filtrovaných požiadaviek.

• Obmedzenia pre uložené procedúry (vzťahuje sa na azure SQL, databázu SQL v službe Fabric a sklady údajov):

  • Rozhranie API používa pre GraphQL iba prvú množinu výsledkov vrátenú uloženou procedúrou.
  • Podporované sú iba tie uložené procedúry, ktorých metaúdaje pre prvú množinu výsledkov popísanú v sys.dm_exec_describe_first_result_set sú podporované.
  • Keď je parameter uloženej procedúry zadaný v konfiguračnom súbore aj v reťazci dotazu URL, parameter v reťazci dotazu URL adresy má prednosť.
  • Entity spravované uloženou procedúrou nemajú všetky možnosti automaticky poskytované pre entity, ktoré sú podporované tabuľkami alebo zobrazeniami.
  • Uložené entity záložných procedúr nepodporujú stránkovanie, zoradenie ani filtrovanie. Takéto entity nepodporujú ani vrátenie položiek zadaných hodnotami primárneho kľúča.

• Časový limit požiadavky je aktuálne 100 sekúnd. To znamená, že ak vydáte požiadavku, ktorá vygeneruje dotaz zdroja údajov dlhší ako 100 sekúnd, požiadavka môže zlyhať a môže zlyhať.

• Maximálna podporovaná hĺbka dotazu je 10. Hĺbka dotazu predstavuje úroveň vnorenia polí v dotaze, ktorá môže v dôsledku potenciálnej rekurzie a nadmernej načítavanie údajov ovplyvniť výkon.

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

• API pre prehľadu jazyka GraphQL
• pripojenie aplikácií k rozhraniu API služby Fabric pre GraphQL
• API pre najčastejšie otázky GraphQL