Megosztás:

API létrehozása a GraphQL-hez a Fabricben, és adatok hozzáadása

A GraphQL-hez készült Fabric API használatának első lépéseit egy API létrehozásával, majd egy adatforrás csatolásával teheti elérhetővé az API-n keresztül kiválasztott adatokat. A Fabric az adatok alapján automatikusan létrehozza a GraphQL-sémát, és az alkalmazások percek alatt készen állnak a csatlakozásra.

Ki hozhat létre GraphQL API-kat?

A GraphQL API-k létrehozása a Fabricben a következő célokra lett kialakítva:

  • Az adatmérnökök modern API-kon keresztül elérhetővé teszik a Fabric lakehouse-t és a raktári adatokat alkalmazások számára.
  • Háló-munkaterület közreműködői , akik háttérkód írása nélkül szeretnének gyorsan létrehozni adatelérési API-kat
  • Egyéni elemzési alkalmazásokat fejlesztő BI-fejlesztők, amelyek programozott hozzáférést igényelnek a Fabric-adatokhoz
  • Adatelérési rétegeket létrehozó integrációs fejlesztők egyéni alkalmazásokhoz és automatizált munkafolyamatokhoz
  • Fejlesztői csapatok , akik a GraphQL rugalmas, típusbiztos megközelítését részesítik előnyben a közvetlen adatbázis-kapcsolatoknál

Ezt az útmutatót akkor használhatja, ha létre kell hoznia egy új GraphQL API-t, amely elérhetővé teszi a Fabric lakehouse, a raktár vagy az adatbázis adatait az alkalmazások számára.

Előfeltételek

A GraphQL-hez készült API létrehozásához a következőkre van szükség:

Az Ön engedélyei:

  • Legyen a Fabric-munkaterület tagja, ahol létre szeretné hozni az API-t
  • Legyen az adott munkaterületen legalább a Közreműködő szerepkörben (vagy magasabb: Tag, Rendszergazda)

Szervezeti beállítás:

  • A Fabric adminisztrátornak vagy kapacitásadminisztrátornak engedélyeznie kell a "Felhasználók létrehozhatnak Fabric elemeket" bérlői beállítást

    Képernyőkép a bérlői beállításokról és arról, hol lehet engedélyezni a lehetőséget, hogy a felhasználók Fabric-elemeket hozhassanak létre.

  • A munkaterületet Fabric kapacitással (Prémium, Próbaverziós vagy Fabric kapacitás) kell alátámasztani.

Adatforrás-hozzáférés (a későbbi lépésekhez):

  • Olvasási engedélyek a GraphQL API-n keresztül elérhetővé tenni kívánt adatforrásokhoz
  • Az engedélyek munkaterület-tagsággal vagy közvetlen adatforrás-engedélyekkel adhatók meg
  • Ebben az útmutatóban egy tükrözött adatbázishoz társított AdventureWorks SQL Analytics-végpontot használunk példaadatforrásként. Az AdventureWorks mintaadatainak lekéréséhez tekintse meg az AdventureWorks-mintaadatok betöltését az SQL-adatbázisban.

API létrehozása a GraphQL-hez

API létrehozása a GraphQL-hez:

  1. Nyissa meg a Fabric portált, https://fabric.microsoft.com és jelentkezzen be a szervezeti fiókjával.

  2. Jelölje ki azt a munkaterületet, ahol létre szeretné hozni az API-t, majd válassza az Új elemet. A megnyíló panelen, az Adatok fejlesztéseterületen válassza Api for GraphQLlehetőséget.

    Képernyőkép a munkaterület eszköztáráról, amelyen az Új lehetőség kiválasztása látható.

  3. Adja meg az új API nevét a GraphQL-elemhez, és válassza a Létrehozás lehetőséget.

Most már aktív GraphQL API-végpontja van a Fabricben. Ezen a ponton átmásolhatja a végpont URL-címét a Háló portálról, a Kód létrehozása gombra kattintva kódmintákat kérhet le, és az API készen áll a kérések fogadására. A következő szakaszban adatforrásokat fogunk csatlakoztatni a séma létrehozásához, de maga a végpont már működik.

Csatlakozás adatforráshoz és a séma létrehozása

Ezen a ponton az API-végpont készen áll, de még nem ad ki adatokat. A GraphQL API-jait típusok és mezők szerint rendezett sémák határozzák meg egy erősen gépelt rendszerben. A Fabric automatikusan létrehozza a szükséges GraphQL-sémát a GraphQL-ügyfelek számára elérhetővé tenni kívánt adatok alapján.

Adatforrás csatlakoztatása és séma létrehozása:

  1. Győződjön meg arról, hogy kiválasztotta az új GraphQL API-elemet a munkaterületen.

  2. Az Adatok hozzáadása a GraphQL API-hoz területen válassza az Adatforrás kiválasztása csempét.

    Képernyőkép az Adatforrás kiválasztása csempéről.

  3. Ezután válassza ki az API csatlakozási lehetőségét:

    Képernyőkép a Kapcsolat kiválasztása lehetőség ablakáról.

    Itt megadhatja, hogy az API-ügyfelek hogyan férhetnek hozzá az API-hoz a GraphQL-kérések végrehajtásához két különböző beállítás alapján:

    • Egyszeri bejelentkezés (SSO): Az ügyfél hitelesítő adataival csatlakozhat adatforrásokhoz. A hitelesített API-felhasználónak hozzáféréssel kell rendelkeznie az adatforrás mögöttes tábláihoz.

      Ha például Lakehouse-adatokat ad ki az API-ügyfeleknek, a hitelesített felhasználónak hozzá kell férnie az API-hoz és a Lakehouse-hoz is. Pontosabban a GraphQL API-ra vonatkozó engedélyek végrehajtása (Lekérdezések és mutációk futtatása lehetőség közvetlen hozzáférési engedélyek hozzáadásakor), valamint a választott adatforrásban szükséges olvasási vagy írási engedélyek végrehajtása. Azt is megteheti, hogy a felhasználó munkaterület-tagként olyan közreműködői szerepkörrel rendelkezik, ahol az API és az adatforrás elemei is találhatók, ami biztosítja a szükséges hozzáférést mindkét elemhez egyetlen helyről. További információt a munkaterületekhez való hozzáférés biztosítása a felhasználóknak című témakörben talál.

    • Mentett hitelesítő adatok: Mentett hitelesítő adatokkal csatlakozhat adatforrásokhoz. A hitelesített API-felhasználónak nincs szüksége az adatokhoz való közvetlen hozzáférésre. A mentett hitelesítő adatok meg lesznek osztva az API és az adatforrás mögöttes táblái közötti adatok eléréséhez.

      Ha például Lakehouse-adatokat ad ki az API-ügyfeleknek, a hitelesített felhasználónak csak közvetlen hozzáféréssel kell rendelkeznie az API-hoz (lekérdezések és mutációk futtatása közvetlen hozzáférési engedélyek hozzáadásakor), és nem a Lakehouse-hoz. A mentett hitelesítő adatok az API adatforráshoz való csatlakoztatására szolgálnak, és az összes hitelesített API-felhasználó megosztja őket. Ez a lehetőség akkor szükséges, ha Egy Azure-adatforrást, például egy Azure SQL-adatbázist a GraphQL-en keresztül ad ki.

    Miután kiválasztotta ezeket a beállításokat, a rendszer az API-hoz később hozzáadott összes adatforrás esetében érvényesíti ezeket a beállításokat. Nem lehet keverni az egyszeri bejelentkezést és a mentett hitelesítő adatokat ugyanabban az API-ban. Az API-hoz való csatlakozáshoz használhat egyszerű felhasználóneveket (UPN-eket) vagy egyszerű szolgáltatásneveket (SPN-eket) SSO vagy mentett hitelesítő adatok használatával a biztonsági követelményeknek megfelelően.

    A különböző hitelesítési forgatókönyvek engedélykövetelményeinek részletes lebontásához tekintse meg a hitelesítés és az engedélyek összegzését.

    Feljegyzés

    A GraphQL API megköveteli, hogy az ügyfélalkalmazások a Microsoft Entra-azonosítót használják a hitelesítéshez. Az ügyfélalkalmazást megfelelően kell regisztrálni és konfigurálni ahhoz, hogy API-hívásokat hajtsanak végre a Fabricen. A Microsoft Entra-azonosítóban regisztrált alkalmazáshoz GraphQLApi.Execute.All API-engedély szükséges a Power BI szolgáltatáshoz. A Connect Applications szolgáltatásnevekhez és a felhasználói tagokhoz tartozó utasításokat és mintakódot tartalmazó, végpontok közötti oktatóanyagot is találhat.

  4. A OneLake katalógusból válassza ki azt az adatforrást, amelyhez csatlakozni szeretne. Válassza a Szűrő lehetőséget, ha csak bizonyos típusú Háló-adatforrásokat szeretne látni, vagy egy adott kulcsszó alapján szeretne keresni. Ha elkészült, válassza a Csatlakozás lehetőséget.

    Képernyőkép a OneLake-adatközpontról, amelyen egy munkaterület elérhető adatforrás-beállításai láthatók.

    Ebben a példában az AdventureWorks-mintaadatokat tartalmazó tükrözött adatbázishoz társított SQL Analytics-végpontot választottuk.

  5. Ha korábban a Mentett hitelesítő adatok lehetőséget választotta, és még nincs mentett hitelesítő adat a GraphQL API-hoz, a rendszer kérni fogja, hogy hozzon létre egy új mentett hitelesítő adatot.

  6. Megjelenik az Adatok kiválasztása lap, ahol kiválaszthatja, hogy mely objektumokat szeretné megjeleníteni a GraphQL-sémában.

  7. Jelölje be az API-ban elérhetővé tenni kívánt táblák, nézetek vagy tárolt eljárások melletti jelölőnégyzeteket. Ha egy mappában lévő összes objektumot ki szeretné jelölni, jelölje be az adatforrás nevét tartalmazó jelölőnégyzetet a tetején.

    Képernyőkép az adatkezelőről egy kijelölt mappával, amely automatikusan kijelöli a mappában lévő összes elemet.

  8. A GraphQL-sémalétrehozási folyamat elindításához válassza a Betöltés lehetőséget.

  9. A séma létrejön, és megkezdheti a GraphQL-lekérdezések (olvasás, lista) vagy mutációk (létrehozás, frissítés, törlés) prototípusát az adatok kezeléséhez.

    Képernyőkép a Sémakezelő képernyőről.

    Jótanács

    A Ctrl/Cmd + szóköz billentyűkombinációval javaslatokat kaphat a lekérdezések szerkesztőben való írása közben.

    Az API-szerkesztő használatáról további információt a Fabric API for GraphQL-szerkesztőben talál.

Összefoglalás

Ennyi az egész! Sikeresen létrehozott egy GraphQL API-t a Fabricben, csatlakoztatta az adatforrást, és létrehozott egy sémát. Az API most már készen áll az ügyfélalkalmazások kapcsolatainak és kéréseinek elfogadására. Az API-szerkesztővel tesztelheti és prototípusba állíthatja a GraphQL-lekérdezéseket, és a Sémakezelővel ellenőrizheti az API-ban közzétett adattípusokat és mezőket.

Kapcsolódó tartalom

  • Last updated on