Sdílet prostřednictvím

Vytvoření rozhraní API pro GraphQL v prostředcích infrastruktury a přidání dat

  • Článek

Poznámka:

Rozhraní Microsoft Fabric API pro GraphQL je ve verzi Preview.

Začněte s rozhraním API Fabric pro GraphQL vytvořením rozhraní API a následným propojením zdroje dat a zveřejněním dat, která jste zvolili prostřednictvím rozhraní API. Prostředky infrastruktury sestavují schéma GraphQL automaticky na základě vašich dat a aplikace jsou připravené k připojení v řádu minut.

Požadavky

  • Kapacita Fabric Premium nebo zkušební verze
  • Povolení nastavení Správa tenanta pro rozhraní API pro GraphQL (Preview)

Vytvoření rozhraní API pro GraphQL

Vytvoření rozhraní API pro GraphQL:

  1. Na portálu Fabric vyberte Datoví technici z přepínače úloh v dolní části navigačního panelu. Pokud jste na domovské stránce Fabric, můžete také vybrat kartu Datoví technici.

    Snímek obrazovky s možností Datoví technici v přepínači úloh

  2. Vyberte rozhraní API pro GraphQL (Preview).

    Snímek obrazovky s dlaždicí rozhraní API, kterou vyberete k vytvoření nové položky rozhraní API

    Alternativně vyberte Nové>rozhraní API pro GraphQL (Preview) z libovolného pracovního prostoru v Datoví technici ingu.

    Snímek obrazovky s panelem nástrojů pracovního prostoru zobrazující, kde vybrat možnost Nový

  3. Zadejte název položky a vyberte Vytvořit.

    Snímek obrazovky s dialogovým oknem Nové rozhraní API pro GraphQL zobrazující, kde zadat název a vybrat Vytvořit

Teď máte plně funkční rozhraní API pro přístup k datům v Prostředcích infrastruktury.

Připojení ke zdroji dat a sestavení schématu

V tuto chvíli je rozhraní API připravené, ale nevystavuje žádná data. Rozhraní API pro GraphQL jsou definována ve schématu uspořádané z hlediska typů a polí v systému silného typu. Prostředky infrastruktury automaticky generují potřebné schéma GraphQL na základě dat, která se rozhodnete zpřístupnit klientům GraphQL.

  1. V novém rozhraní API zvolte zdroj dat, který chcete zveřejnit, a to tak, že zvolíte Vybrat zdroj dat.

    Snímek obrazovky s možností Vybrat zdroj dat

  2. Zobrazí se datové centrum OneLake; zvolte zdroj dat, ke kterému se chcete připojit. V následujícím příkladu zvolíme koncový bod analýzy SQL AdventureWorks propojený se zrcadlenou databází. Výběrem možnosti Filtr zobrazíte pouze konkrétní typy zdrojů dat infrastruktury nebo můžete hledat podle konkrétního klíčového slova. Až budete připraveni, vyberte Připojení.

    Snímek obrazovky s datovým centrem OneLake zobrazující dostupné možnosti zdroje dat pro pracovní prostor

  3. Zobrazí se obrazovka Získat data , kde můžete zvolit, které objekty chcete zobrazit ve schématu GraphQL.

    Snímek obrazovky Získat data zobrazující seznam Zvolit data

  4. Zaškrtněte políčka vedle jednotlivých tabulek nebo uložených procedur, které chcete zpřístupnit v rozhraní API. Pokud chcete vybrat všechny objekty ve složce, zaškrtněte políčko s názvem zdroje dat v horní části.

    Snímek obrazovky se seznamem Zvolit data s vybranou složkou, která automaticky vybere všechny položky v této složce

  5. Výběrem možnosti Načíst spustíte proces generování schématu GraphQL.

  6. Schéma se vygeneruje a můžete začít vytvářet prototypy dotazů GraphQL (čtení, seznam) nebo mutací (vytváření, aktualizace, odstranění) pro interakci s daty.

    Snímek obrazovky Průzkumníka schématu

Vaše rozhraní API pro GraphQL je teď připravené přijímat připojení a požadavky. Pomocí editoru rozhraní API můžete testovat a prototypovat dotazy GraphQL a Průzkumníka schématu k ověření datových typů a polí vystavených v rozhraní API.

Související obsah