Najděte odpovědi na nejčastější dotazy k rozhraní Fabric API pro GraphQL.
Co je GraphQL?
GraphQL je dotazovací jazyk pro rozhraní API, která aplikacím umožňuje požadovat přesně potřebná data. Mezi klíčové výhody patří:
- Systém silného typu – jasně popisuje dostupná data
- Přesné načítání dat – snižuje nadměrné načítání povolením konkrétních požadavků.
- Zpětná kompatibilita – Usnadňuje aktualizace rozhraní API bez přerušení existujícího kódu.
- Bohaté možnosti nástrojů – umožňuje použití široké škály vývojářských nástrojů
Je to efektivnější způsob, jak aplikace komunikovat se servery a databázemi.
Co je rozhraní API Microsoft Fabric pro GraphQL?
Microsoft Fabric API pro GraphQL je spravovaná služba, která umožňuje vytvořit GraphQL API za několik sekund.
Podporované zdroje dat:
- datové sklady Microsoft Fabric
- Microsoft Fabric Lakehouses
- Microsoft Fabric zrcadlené databáze
- Microsoft Fabric SQL Databáze
- databáze Azure SQL
Poskytuje jednotnou vrstvu rozhraní API pro dotazování a mutaci dat z těchto podporovaných zdrojů dat.
Jaké operace GraphQL jsou podporované v rozhraní API fabric pro GraphQL?
V současné době se podporují pouze dotazy GraphQL (čtení) a mutace (zápis). Zdroje dat zveřejněné prostřednictvím koncových bodů SQL Analytics jsou jen pro čtení, takže podporují pouze dotazy. U datových skladů je potřeba definovat primární klíč pro automatické generování mutací.
Jak můžu zobrazit a upravit resolvery v API Fabric pro GraphQL?
Překladače jsou komponenty GraphQL, které poskytují obchodní logiku pro překlad polí v rozhraní API a provádění operací s daty umístěnými ve zdrojích dat.
Automatické generování: Fabric automaticky generuje resolvery pokaždé, když připojíte nový datový zdroj nebo vyberete nové objekty pro vystavení z existujícího datového zdroje.
Přizpůsobení: V současné době není možné resolvery přizpůsobit přímo. Pro přizpůsobenou obchodní logiku v rozhraní API pro GraphQL můžete vytvořit uloženou proceduru ve zdroji dat a zpřístupnit ji v rozhraní GraphQL API.
Vyžaduje rozhraní API pro klientskou aplikaci GraphQL access ke zdroji dat k provádění dotazů nebo mutací?
Microsoft Entra ID authentication: API pro GraphQL vyžaduje, aby aplikace k ověřování používaly Microsoft Entra ID. Klientská aplikace musí být zaregistrovaná a nakonfigurovaná tak, aby prováděla volání rozhraní API vůči systému Fabric.
Požadovaná oprávnění:
- Aplikace zaregistrovaná v Microsoft Entra vyžaduje oprávnění GraphQLApi.Execute.All pro Power BI service. Další informace najdete v tématu Vytvoření aplikace Microsoft Entra v Azure.
Konfigurace jednotného přihlášení (SSO): Pokud je rozhraní API nakonfigurované tak, aby používalo jednotné přihlášení, ověřený uživatel nebo instanční objekt vyžaduje přístup k obojí:
- Rozhraní GraphQL API (oprávnění ke spouštění dotazů a mutací )
- Zdroj dat (přístup pro čtení nebo zápis podle potřeby)
Možnost přístupu na úrovni pracovního prostoru: Případně přiřaďte uživatele nebo služebního principála jako člena pracovního prostoru s rolí přispěvatele, kde se nacházejí položky rozhraní API i zdroje dat. To poskytuje potřebný přístup k oběma položkám z jednoho místa. Další informace naleznete v části Poskytování přístupu uživatelům k pracovním prostorům.
Konfigurace uložených přihlašovacích údajů: Pokud je rozhraní API nakonfigurováno tak, aby používalo uložené přihlašovací údaje, ověřený uživatel nebo hlavní služba musí mít přístup k rozhraní API (při přidávání přímých oprávnění pro přístup k rozhraní API vyberte možnost Spustit dotazy a operace Mutací).
Příklady: Kompletní příklad s ukázkovým kódem pro uživatelské identity i služební identity najdete v Connect Applications.
Jak mohu vytvořit tiket podpory pro API GraphQL?
Pokud chcete získat pomoc od Microsoft Support ohledně jakýchkoli problémů souvisejících s rozhraním Fabric API pro GraphQL, navštivte náš web podpory Fabric Support a zvolte možnost Data Engineering.
Podporuje rozhraní API pro GraphQL Private Link?
Rozhraní API pro GraphQL v současnosti podporuje pouze Private Link úrovně tenanta.
Proč moje žádost funguje špatně při prvním vydání žádosti a pak dobře funguje s dalšími požadavky?
Toto chování "studeného startu" má dva hlavní důvody:
Zahřátí zdroje dat:
- První požadavek může trvat déle, pokud je potřeba zdroj dat zahřívat ze studeného stavu.
- I když zdroj dat není studený, nemusí být načítání dat tak efektivní, když GraphQL poprvé vydá dotaz, pokud zdroj dat neobsahuje potřebná data načtená do paměti.
Inicializace koncového bodu rozhraní API:
- První požadavek na koncový bod GraphQL pro rozhraní API může trvat déle, protože systém potřebuje načíst schéma a konfiguraci.
- Následné požadavky jsou rychlejší, protože systém je již připraven a připravený ke zpracování vašich požadavků.
Další informace najdete v osvědčených postupech pro výkon.
Jak můžu poskytnout zpětnou vazbu nebo návrhy pro rozhraní API pro GraphQL?
Vítáme vaše názory a návrhy. Zpětnou vazbu můžete poskytnout prostřednictvím Nápady na Fabric. Náš tým aktivně sleduje zpětnou vazbu a návrhy odeslané prostřednictvím této platformy. S námi se můžete také spojit prostřednictvím podpory Microsoft Fabric pro všechny konkrétní dotazy nebo obavy.