Vytvorenie rozhrania API pre GraphQL v službe Fabric a pridanie údajov

Začnite pracovať s rozhraním API služby Fabric pre GraphQL vytvorením rozhrania API a potom prepojte zdroj údajov, aby ste sprístupnili údaje, ktoré ste vybrali prostredníctvom rozhrania API. Fabric vytvorí schému GraphQL automaticky na základe vašich údajov a aplikácie sú pripravené na pripojenie v priebehu niekoľkých minút.

Požiadavky

• Povoľte nastavenie nájomníka Používatelia môžu vytvárať položky služby Fabric správcu.

Vytvorenie rozhrania API pre GraphQL

Vytvorenie rozhrania API pre GraphQL:

1. Vyberte Položku z ľubovoľného pracovného priestoru. Na otvorínom paneli v časti Vyvinúťúdajov vyberte pre GraphQLpoložku API .

   

2. Zadajte Názov položky a vyberte položku Vytvoriť.

   

Teraz máte plne funkčné rozhranie API na prístup k údajom v službe Fabric.

Pripojenie k zdroju údajov a vytvorenie schémy

V tomto bode je rozhranie API pripravené, ale nezobrazujú sa žiadne údaje. Rozhrania API pre GraphQL sú definované v schéme usporiadanej v typoch a poliach v silno zaradenom systéme. Fabric automaticky vygeneruje potrebnú schému GraphQL na základe údajov, ktoré sa rozhodnete sprístupniť klientom GraphQL.

1. Vo svojom novom rozhraní API vyberte zdroj údajov, ktorý chcete sprístupniť, a to výberom položky Vybrať zdroj údajov.

   

2. Ďalej vyberte možnosť pripojenia pre svoje rozhranie API:

   

   Tu môžete definovať, ako môžu klienti rozhrania API pristupovať k rozhraniu API na vykonanie požiadaviek GraphQL na základe dvoch odlišných možností:

   • Jediné prihlásenie (SSO): na pripojenie k zdrojom údajov použite klientske poverenia, čo znamená, že overený používateľ rozhrania API musí mať prístup k základnému zdroju údajov. Ak napríklad zobrazujete údaje lakehouse svojim klientom rozhrania API, overený používateľ musí mať prístup k rozhraniu API aj k službe Lakehouse. Presnejšie povedané, Execute povolenia pre rozhranie GraphQL API (možnosť Spustiť dotazy a mutácie pri pridávaní povolení priameho prístupu) a povolenia na čítanie alebo zapisovanie požadované v zdroji údajov podľa výberu. Prípadne môže byť používateľ pridaný ako člen pracovného priestoru s rolou prispievateľa kde sa nachádza rozhranie API aj položky zdroja údajov, čo poskytne požadovaný prístup k obom položkám z jedného umiestnenia. Ďalšie informácie nájdete v téme Poskytnutie prístupu používateľom k pracovným priestorom.
   • Uložené poverenia: na pripojenie k zdrojom údajov použite uložené poverenia, čo znamená, že overený používateľ rozhrania API nevyžaduje priamy prístup k zdroju údajov. Uložené prihlasovacie údaje sa zdieľajú na prístup k údajom medzi rozhraním API a základnými tabuľkami v zdroji údajov. Ak napríklad zobrazujete údaje lakehouse svojim klientom rozhrania API, overený používateľ musí mať priamy prístup k rozhraniu API (možnosť Spustiť dotazy a mutácie pri pridávaní povolení priameho prístupu) a nie k službe Lakehouse. Uložené prihlasovacie údaje sa používajú na pripojenie rozhrania API k zdroju údajov a sú zdieľané všetkými overenými používateľmi rozhrania API. Táto možnosť sa vyžaduje, ak zobrazujete zdroj údajov Azure, ako je napríklad databáza Azure SQL cez GraphQL. Po výbere tlačidla OK sa zobrazí výzva na vytvorenie nového uloženého poverenia po výbere zdroja údajov v ďalšom kroku, ak už nie je uložené prihlasovacie údaje preň.

   Po výbere týchto možností sa vynútia pre všetky zdroje údajov následne pridané do rozhrania API. Nie je možné premiešať jediné prihlásenie a uložené poverenia v tom istom rozhraní API. Okrem toho, hoci môžete na pripojenie k rozhraniu API použiť hlavné názvy používateľov (UPN) alebo hlavné názvy služby (SPN), objekty služby aktuálne podporujú iba jediné prihlásenie (SSO). Subjekty používateľa môžu využívať prihlasovacie údaje jediného prihlásenia alebo uložené poverenia v závislosti od požiadaviek zabezpečenia.

   Poznámka

   Rozhranie API pre GraphQL vyžaduje, aby klientske 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 službe Microsoft Entra ID vyžaduje GraphQL.Execute.All povolenia rozhrania API pre službu Power BI. Komplexný kurz s pokynmi a vzorovým kódom pre objekty používateľa aj objekty služby nájdete v časti Pripojiť aplikácie.

3. Zobrazí sa údajové centrum OneLake; Vyberte zdroj údajov, ku ktorému sa chcete pripojiť. V nasledujúcom príklade si vyberieme koncový bod analýzy AdventureWorks SQL prepojený so zrkadlovým databázou. Ak chcete zobraziť iba konkrétne typy zdrojov údajov služby Fabric, vyberte položku Filter alebo vyhľadajte konkrétne kľúčové slovo. Keď budete pripravení, vyberte položku Pripojiť.

   

4. Zobrazí sa obrazovka Získať údaje , na ktorej môžete vybrať, ktoré objekty sa majú zobraziť v schéme GraphQL.

   

5. Začiarknite políčka vedľa jednotlivých tabuliek alebo uložených procedúr, ktoré chcete zobraziť v rozhraní API. Ak chcete vybrať všetky objekty v priečinku, začiarknite políčko s názvom zdroja údajov v hornej časti.

   

6. Výberom položky Načítať spustite proces generovania schémy GraphQL.

7. Schéma sa vygeneruje a môžete začať vytvárať prototypy dotazov GraphQL (čítanie, zoznam) alebo mutácie (vytvoriť, aktualizovať, odstrániť) a pracovať s údajmi.

   

Vaše rozhranie API pre GraphQL je teraz pripravené na prijímanie pripojení a požiadaviek. Editor rozhrania API môžete použiť na testovanie a prototyp dotazov GraphQL a prieskumníka schémy na overenie typov údajov a polí zverejnených v rozhraní API.

Súhrn povolení

V tabuľke nižšie sa sumarizujú rôzne podporované permutácie a minimálne požadované povolenia pre klientov, ktorí pristupujú k rozhraniu GraphQL API:

Súvisiaci obsah

• Rozhranie API služby Fabric pre editor GraphQL
• Rozhranie API služby Fabric pre zobrazenie schémy GraphQL a prieskumníka schém