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. Používá systém silného typu k jasnému popisu dostupných dat, snižuje nadměrné načítání tím, že umožňuje přesné požadavky, usnadňuje aktualizace rozhraní API bez přerušení stávajícího kódu a umožňuje použití široké sady vývojářských nástrojů. Je to efektivnější způsob, jak aplikace komunikovat se servery a databázemi.
Co je rozhraní Microsoft Fabric API pro GraphQL?
Rozhraní Microsoft Fabric API pro GraphQL je spravovaná služba, která umožňuje vytvořit rozhraní GraphQL API za několik sekund pro přístup k datům z vašich zdrojů dat, jako jsou Microsoft Fabric Data Warehouses, Microsoft Fabric Lakehouses, Microsoft Fabric Mirrored Databases, Microsoft Fabric SQL Database a Azure SQL Databases. Poskytuje jednotnou vrstvu rozhraní API pro dotazování a ztlumení 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 muty (zápis). Zdroje dat zveřejněné prostřednictvím koncových bodů SQL Analytics jsou jen pro čtení, takže podporují pouze dotazy. V případě datových skladů je potřeba definovat primární klíč pro automatické generování mutací.
Jak můžu zobrazit a upravit překladače v rozhraní FABRIC API 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. Prostředky infrastruktury automaticky generují překladače pokaždé, když připojíte nový zdroj dat nebo vyberete nové objekty, které se mají vystavit z existujícího zdroje dat. V současné době není možné přizpůsobit překladače. 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 přístup ke zdroji dat, aby bylo možné provádět dotazy nebo mutaci?
Rozhraní API pro GraphQL vyžaduje, aby aplikace k ověřování používaly ID Microsoft Entra. Vaše klientská aplikace musí být zaregistrovaná a nakonfigurovaná adekvátně, aby bylo možné spouštět volání rozhraní API proti prostředkům infrastruktury. Aplikace zaregistrovaná v Microsoft Entra vyžaduje oprávnění GraphQLApi.Execute.All pro službu Power BI. Další informace najdete v tématu Vytvoření aplikace Microsoft Entra v Azure. Kromě Microsoft Entra, pokud je rozhraní API nakonfigurované tak, aby používalo jednotné přihlašování (SSO), ověřený uživatel nebo instanční objekt v aplikaci volající rozhraní GraphQL API vyžaduje přístup k rozhraní GraphQL API i ke zdroji dat. Konkrétně v rozhraní GraphQL API s oprávněním Ke spouštění dotazů a grafů a přístupu ke čtení nebo zápisu požadovaným ve zvoleném zdroji dat. Další možností je mít uživatele nebo instanční objekt jako člena pracovního prostoru s rolí přispěvatele , kde se nachází rozhraní API i položky zdroje dat, což umožňuje požadovaný přístup k oběma položkám z jednoho místa. Další informace najdete v tématu Udělení přístupu uživatelům k pracovním prostorům. Pokud je rozhraní API nakonfigurované tak, aby používalo uložené přihlašovací údaje, musí mít ověřený uživatel nebo instanční objekt jenom přístup k rozhraní API (při přidávání přímých přístupových oprávnění k rozhraní API vyberte Spustit dotazy a mutované dotazy možnost). Kompletní příklad s ukázkovým kódem pro instanční objekty i instanční objekty najdete v aplikaci Connect Applications.
Návody otevřít lístek podpory pro rozhraní API pro GraphQL?
Pokud chcete získat pomoc od podpora Microsoftu o všech potížích souvisejících s rozhraním API Fabric pro GraphQL, navštivte náš web podpory prostředků infrastruktury a zvolte možnost Datoví technici.
Podporuje rozhraní API pro GraphQL službu Private Link?
Rozhraní API pro GraphQL v tuto chvíli nepodporuje službu Private Link. Plánujeme ale tuto funkci v budoucnu podporovat a budeme poskytovat aktualizace, jakmile budou k dispozici.
Povolil(a) jsem službu Private Link pro svého tenanta Fabric. Proč moje položky GraphQL nefungují?
Pokud je povolené nastavení tenanta Blokovat veřejný přístup k internetu (tj. veřejný přístup je zakázaný), všechny nepodporované artefakty nebo položky se automaticky deaktivují, včetně rozhraní API pro GraphQL. To znamená, že dříve vytvořené položky nelze získat přístup ani vytvářet nové položky. Jediným způsobem, jak k těmto položkám přistupovat, je povolit veřejný přístup.
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í má dva hlavní důvody. První požadavek může trvat déle, pokud je potřeba zdroj dat zahřát, pokud je studený. I když zdroj dat není studený, nemusí být načítání dat tak efektivní při prvním vydání dotazu GraphQL, pokud zdroj dat nemá potřebná data načtená do paměti. Druhým důvodem je to, že první požadavek na koncový bod GraphQL pro rozhraní API pro GraphQL může trvat déle, protože systém potřebuje načíst schéma a konfiguraci, aby mohl přijímat požadavky. Jedná se o jednorázové náklady a následné požadavky jsou rychlejší, protože systém je již zahřeje a je připravený k obsluhě 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 prostředky infrastruktury. Náš tým aktivně sleduje zpětnou vazbu a návrhy odeslané prostřednictvím této platformy. Můžete nás také kontaktovat prostřednictvím podpory Microsoft Fabric pro všechny konkrétní dotazy nebo obavy.