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ú. Medzi hlavné výhody patrí:
- Silný typový systém – Jasne popisuje dostupné údaje
- Presné načítavanie dát – Znižuje nadmerné načítavanie tým, že umožňuje špecifické požiadavky
- Spätná kompatibilita – Uľahčuje aktualizácie API bez poškodenia existujúceho kódu
- Bohaté nástroje - Umožňuje použitie širokej škály developer tools
Ide o efektívnejší spôsob komunikácie aplikácií so servermi a databázami.
Čo je Microsoft Fabric API pre GraphQL?
Microsoft Fabric API pre GraphQL je spravovaná služba, ktorá vám umožní vytvoriť GraphQL API za pár sekúnd.
Podporované zdroje dát:
- Microsoft Fabric dátové sklady
- Microsoft Fabric Lakehouses
- Microsoft Fabric zrkadlené databázy
- Microsoft Fabric SQL databázy
- Azure SQL Databases
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. Pre dátové sklady je potrebné definovať primárny kľúč, aby sa mutácie mohli automaticky generovať.
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.
Automatická generácia: Fabric automaticky generuje resolvery vždy, keď pripojíte nový zdroj dát alebo vyberiete nové objekty na sprístupnenie z existujúceho zdroja dát.
Prispôsobenie: Momentálne nie je možné resolvery priamo prispôsobovať. 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 API pre klientskú aplikáciu GraphQL access k dátovému zdroju na vykonávanie dotazov alebo mutácií?
Microsoft Entra ID autentifikácia: API pre GraphQL vyžaduje, aby aplikácie používali Microsoft Entra ID na autentifikáciu. Vaša klientská aplikácia musí byť registrovaná a nakonfigurovaná na vykonávanie API volaní proti Fabric.
Požadované povolenia:
- Aplikácia registrovaná v Microsoft Entra vyžaduje oprávnenia GraphQLApi.Execute.All pre Power BI service. Pre viac informácií pozri Create a Microsoft Entra app v Azure.
- API GraphQL (Povolenie na spúšťanie dotazov a mutácií )
- Zdroj dát (read alebo write access podľa potreby)
Možnosť access na úrovni pracovného priestoru: Alternatívne priraďte používateľa alebo princípa služby ako člena pracovného priestoru s rolou prispievateľa kde sa nachádzajú API aj položky zdroja dát. To poskytuje potrebný access k obom položkám z jedného miesta. Pre viac informácií pozri Poskytnúť používateľom access pracovných priestorov.
Uložená konfigurácia prihlasovacích údajov: Ak je API nakonfigurované na používanie uložených prihlasovacích údajov, autentifikovaný používateľ alebo princíp služby potrebuje len access do API (pri pridávaní oprávnení Spustiť dotazy a mutácie pri pridávaní oprávnení na priame access do API).
Príklady: End-to-end príklad s ukážkovým kódom pre používateľské aj servisné princípy nájdete na Connect Applications.
How do I otvorím ticket podpory pre API pre GraphQL?
Ak chcete získať pomoc od Microsoft Support s akýmkoľvek problémom týkajúcim sa Fabric API pre GraphQL, navštívte našu stránku Fabric Support a vyberte možnosť Data Engineering.
Podporuje API pre GraphQL Private Link?
API pre GraphQL momentálne podporuje iba Tenant Level Private Link.
Prečo moja žiadosť nefunguje správne pri prvom vydaní a má dobrý výkon pri následných požiadavkách?
Existujú dva hlavné dôvody tohto správania "studeného štartu":
Rozcvička zdrojov dát:
- Prvá požiadavka môže trvať dlhšie, ak je potrebné dátový zdroj zohriať zo studeného stavu
- Aj keď zdroj dát nie je studený, získavanie dát nemusí byť pri prvom vykonaní dotazu od GraphQL také efektívne, ak zdroj dát nemá potrebné údaje nahrané v pamäti
Inicializácia API endpointov:
- Prvá požiadavka na API pre GraphQL endpoint môže trvať dlhšie, pretože systém musí načítať vašu schému a konfiguráciu
- Nasledujúce požiadavky sú rýchlejšie, pretože systém je už rozohriaty a pripravený na spracovanie vašich požiadaviek
Ďalšie informácie nájdete v osvedčených postupoch pri výkone.
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. Môžete nás tiež kontaktovať cez Microsoft Fabric Support s konkrétnymi otázkami alebo obavami.