Osvedčené postupy pri výkone rozhrania GraphQL pomocou rozhrania API služby Fabric

Rozhranie API pre GraphQL služby Microsoft Fabric ponúka výkonný spôsob efektívneho dotazovania údajov, ale optimalizácia výkonu je kľúčom k zabezpečeniu plynulého a škálovateľného výkonu. Či už spracovávate zložité dotazy alebo optimalizujete časy odozvy, nasledujúce osvedčené postupy vám pomôžu získať najlepší výkon z implementácie GraphQL a maximalizovať efektivitu rozhrania API v službe Fabric.

Regiónov

Volania naprieč oblasťami môžu byť vo všeobecnosti príčinou vysokej latencie. Na dosiahnutie najlepšieho výkonu sa odporúča pripojiť klientov k rozhraniam API v tej istej oblasti nájomníka a kapacity.

Oblasť nájomníka

Oblasť nájomníka môžete nájsť podľa nasledujúcich krokov:

1. Prejdite na portál služby Microsoft Fabric s kontom správcu a kliknite v pravom hornom rohu na ikonu Pomocníka ? .
2. V dolnej časti Časti Pomocníka kliknite na prepojenie O látkach .
3. Zobrazia sa podrobnosti o nájomníkovi vrátane oblasti.

Oblasť kapacity

1. Prejdite na portál Microsoft Fabric a otvorte pracovný priestor, ktorý je hostiteľom rozhrania API služby Fabric pre GraphQL.

2. V časti Nastavenia pracovného priestoru prejdite na položku Informácie o licencii.

3. Informácie o oblasti kapacity nájdete v časti Licencia kapacity.

   

Oblasť zdroja údajov

1. Ak je zdroj údajov hosťovaný na platforme Fabric, oblasť kapacity pracovného priestoru bude oblasťou zdroja údajov.

2. Ak je váš zdroj údajov mimo platformy Služby Fabric, napríklad databáza Azure SQL, mali by ste mať možnosť nájsť miestne informácie na portáli Azure.

Testovanie výkonu

Zákazníkom, ktorí vyhodnocujú svoj výkon rozhrania API, odporúčame dodržiavanie nasledujúcich pokynov, aby sa zaistili konzistentné a spoľahlivé výsledky.

Nástroje na strane klienta

Ak chcete emulovať správanie skrine vo svojej aplikácii, na meranie výkonu sa odporúča použiť skripty alebo ukážkovú webovú aplikáciu. Okrem toho môže použitie združovania pripojení HTTP výrazne znížiť latencie, najmä v prípade scenárov medzi oblasťami.

Môžete použiť tento vzorový skript testu výkonu , ktorý vám pomôže začať.

Súvisiace články:

• Pokročilé použitie – dokumentácia k žiadostiam 2.32.3

• Pokyny pre HttpClient pre .NET

Zhromažďovanie a vyhodnocovanie údajov

Odporúča sa automatizovať spúšťanie požiadaviek počas presne definovaného časového obdobia pomocou skriptov alebo nástrojov na testovanie výkonu. Analýza priemerných alebo percentilových výsledkov pomáha zabezpečiť presnejšie a nezaujaté merania výkonu.

Bežné problémy

Tu je zoznam bežných problémov, ktoré môžu mať vplyv na latenciu a výkon rozhrania API.

• Geografická poloha vášho klienta sa líši od vášho nájomníka a oblasti kapacity:

  • Ak plánujete pre svoju aplikáciu dosiahnuť čo najlepší výkon, s klientmi a zdrojmi rozhrania API v tej istej oblasti môžete dosiahnuť tento cieľ.

• Pred testovaním niekoľkokrát vytvorte dotaz na rozhranie API pre GraphQL:

  • Rozhranie API pre GraphQL nepoužíva ani nepoužíva kapacitu (CU) v prípade nečinnosti. Čo znamená, že prostredie rozhrania API sa musí inicializovať interne počas prvého volania, čo trvá niekoľko sekúnd navyše. Rozhranie API pre GraphQL má interné mechanizmy ukladania do vyrovnávacej pamäte, ktoré pomáhajú znížiť latencie spojitých volaní, avšak v prípade počiatočných volaní môžete čeliť špičkám latencie.
  • Okrem samotného rozhrania API je známe, že určité zdroje údajov sú podrobené fáze rozcvičky, čo bude mať za následok vyššie latencie počiatočných požiadaviek. Ak rozhranie API pristupuje k zdroju údajov, ktorý je tiež nečinný a je potrebné ho inicializovať aj počas prvého spustenia, oneskorenie je vyššie, pretože musí čakať na inicializáciu zdroja údajov aj rozhrania API.
  • Následné volania sú rýchlejšie, pretože inicializácia prostredia prebieha iba raz.

• Nastavenie zdroja údajov a kapacity služby Fabric.

  • Rozhranie API pre GraphQL si môžete predstaviť ako obal na základe zdrojov údajov. Ak má samotný zdroj údajov problémy s výkonom v dôsledku povahy jeho zložitosti, očakáva sa, že latencie rozhrania API môžu byť vysoké. V prípade takýchto prípadov sa odporúča priamo otestovať dotazovanie zdrojov údajov, aby bolo efektívnejšie porovnanie výkonu s rozhraním API pre GraphQL.

    • Postupujte podľa tejto príručky a zistite, ako si vybrať vhodný ukladací priestor údajov pre potreby vášho podniku: Príručka pre rozhodnutia v službe Fabric – výber úložiska údajov

  • Pri prístupe k API pre GraphQL bude výkon viazaný kapacitou služby Fabric SKU, ktorú ste si vybrali.

    • Pozrite si tieto všeobecné pokyny týkajúce sa kapacity služby Fabric SKU a jej výpočtovej sily: Koncepty služby Microsoft Fabric

Výkon rozhrania API môže ovplyvniť niekoľko faktorov. Na optimalizáciu je rozhodujúce pochopenie nastavenia zdroja údajov, výber správnych oblastí a efektívne meranie výkonu.

Súvisiaci obsah

• Fabric API pre prehľad GraphQL
• Rozhranie API služby Fabric pre editor GraphQL