Nájdite odpovede na najčastejšie kladené otázky o rozhraní API služby Fabric na otázky v jazyku GraphQL.
Čo je GraphQL?
GraphQL je jazyk dotazov pre rozhrania API, ktorý umožňuje aplikáciám požadovať presne tie údaje, ktoré potrebujú. Používa silný typ systému na zreteľné popisovanie dostupných údajov, znižuje preťaženie načítavanie tým, že umožňuje presné požiadavky, uľahčuje aktualizácie rozhrania API bez toho, aby sa prerušil existujúci kód, a umožňuje používať širokú množinu vývojárskych nástrojov. Ide o efektívnejší spôsob komunikácie aplikácií so servermi a databázami.
Čo je rozhranie Microsoft Fabric API pre GraphQL?
Rozhranie API služby Microsoft Fabric pre GraphQL je spravovaná služba, ktorá vám umožňuje v sekundách vytvoriť rozhranie API služby GraphQL na prístup k údajom zo zdrojov údajov, ako sú napríklad služby Microsoft Fabric Data Warehouses, Microsoft Fabric Lakehouses, databázy Microsoft Fabric Mirrored, databázy Microsoft Fabric SQL a databázy Azure SQL. Poskytuje jednotnú vrstvu rozhrania API na dotazovanie a mutovanie údajov z týchto podporovaných zdrojov údajov.
Aké operácie s jazykom GraphQL sú podporované v rozhraní API služby Fabric pre GraphQL?
Iba GraphQL dotazy (čítať) a mutácie (písať) sú podporované v súčasnosti. Zdroje údajov exponované prostredníctvom koncových bodov SQL Analytics sú iba na čítanie, čím podporujú iba dotazy. V prípade skladov údajov je potrebné definovať primárny kľúč pre mutácie, ktoré sa majú generovať automaticky.
Ako môžem zobraziť a upraviť prekladače v rozhraní API služby Fabric pre GraphQL?
Resolvers sú súčasti GraphQL, ktoré poskytujú obchodnú logiku na vyriešenie polí v rozhraní API a vykonávajú operácie s údajmi, ktoré sa nachádzajú v zdrojoch údajov. Fabric automaticky generuje prekladače vždy, keď priložíte nový zdroj údajov alebo vyberiete nové objekty, ktoré sa majú zobraziť z existujúceho zdroja údajov. V súčasnosti nie je možné prispôsobiť resolvers. V prípade prispôsobenej obchodnej logiky v rozhraní API pre GraphQL môžete vytvoriť uloženú procedúru v zdroji údajov a zobraziť ju v rozhraní GraphQL API.
Vyžaduje klientska aplikácia API pre klientsku aplikáciu GraphQL prístup k zdroju údajov na vykonávanie dotazov alebo mutácií?
Rozhranie API pre GraphQL vyžaduje, aby aplikácie používali microsoft Entra ID na overovanie. Vaša klientska aplikácia musí byť zaregistrovaná a primerane nakonfigurovaná na vykonanie volaní rozhrania API v službe Fabric. Aplikácia zaregistrovaná v aplikácii Microsoft Entra vyžaduje GraphQLApi.Execute.All povolenia pre službu Power BI. Ďalšie informácie nájdete v téme Vytvorenie aplikácie Microsoft Entra v službe Azure. Okrem služby Microsoft Entra platí, že ak je rozhranie API nakonfigurované na používanie jediného prihlásenia (SSO), overený používateľ alebo objekt služby v aplikácii, ktorá volá rozhranie API GraphQL, vyžaduje prístup k rozhraniu GraphQL API aj k zdroju údajov. Presnejšie povedané, spustiť dotazy a mutácie povolenie v GraphQL API a prístup na čítanie alebo zápis požadované v zdroji údajov voľby zodpovedajúcim spôsobom. Ďalšou možnosťou je, že používateľ alebo objekt služby ako člen pracovného priestoru s rolou prispievateľa , kde sa nachádza rozhranie API aj položky zdroja údajov, čo poskytuje požadovaný prístup k obom položkám z jedného miesta. Ďalšie informácie nájdete v téme Poskytnutie prístupu používateľom k pracovným priestorom. Prípadne, ak je rozhranie API nakonfigurované na používanie uložených poverení, overený používateľ alebo objekt služby musí mať prístup k rozhraniu API (vyberte možnosť Spustiť dotazy a mutácie pri pridávaní povolení na priamy prístup k rozhraniu API). Komplexný príklad so vzorovým kódom pre objekty používateľa aj objekty služby nájdete v časti Pripojiť aplikácie.
Ako otvorím žiadosť o podporu pre rozhranie API pre GraphQL?
Ak chcete získať pomoc od podpory spoločnosti Microsoft v prípade akýchkoľvek problémov týkajúcich sa rozhrania API služby Fabric pre GraphQL, navštívte lokalitu podpory služby Fabric a vyberte možnosť Dátový inžinier ing.
Ktoré oblasti ešte nie sú podporované rozhraním API pre GraphQL?
Rozhranie API pre GraphQL sa v súčasnosti nepodporuje v oblasti Západ USA 3.
Podporuje rozhranie API pre GraphQL službu Private Link?
Rozhranie API pre GraphQL v súčasnosti nepodporuje funkciu Private Link. Túto funkciu však plánujeme v budúcnosti podporovať a budeme poskytovať aktualizácie hneď, ako budú k dispozícii.
Povolil som službu Private Link pre nájomníka služby Fabric. Prečo moje položky v jazyku GraphQL nefungujú?
Ak je nastavenie nájomníka Blokovať verejný prístup na internet povolené (to znamená, že verejný prístup je zakázaný), všetky nepodporované artefakty alebo položky sa automaticky vypnú, a to vrátane rozhrania API pre GraphQL. To znamená, že k predtým vytvoreným položkách nie je možné získať prístup ani vytvárať nové. Jediným spôsobom, ako získať prístup k týmto položkám, je povoliť verejný prístup.
Prečo moja žiadosť nefunguje správne pri prvom vydaní a má dobrý výkon pri následných požiadavkách?
Toto správanie má dva hlavné dôvody. Prvá žiadosť môže najskôr trvať dlhšie, ak sa zdroj údajov musí zohriať, ak je studený. Aj keď zdroj údajov nie je studený, načítanie údajov nemusí byť pri prvom výskyte dotazu v jazyku GraphQL také efektívne, ak zdroj údajov nemá v pamäti načítané potrebné údaje. Druhým dôvodom je, že prvá žiadosť o rozhranie API pre koncový bod GraphQL môže trvať dlhšie, pretože systém musí načítať vašu schému a konfiguráciu, aby mohol byť pripravený na prijímanie požiadaviek. Ide o jednorazovú cenu a následné požiadavky sú rýchlejšie, pretože systém sa už rozcvičí a je pripravený na doručenie vašich požiadaviek.
Ako môžem poskytnúť pripomienky alebo návrhy pre rozhranie API pre GraphQL?
Uvítame vaše pripomienky a návrhy. Pripomienky môžete poskytnúť prostredníctvom Fabric Ideas. Náš tím aktívne monitoruje pripomienky a návrhy odoslané prostredníctvom tejto platformy. Obráťte sa na nás aj prostredníctvom technickej podpory služby Microsoft Fabric na všetky konkrétne dotazy alebo obavy.