Zdieľať cez

Obmedzenia rozhrania Microsoft Fabric API pre GraphQL

  • Článok

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ť.

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