Delen via

Een API voor GraphQL maken in Fabric en gegevens toevoegen

  • Artikel

Ga aan de slag met de Fabric-API voor GraphQL door een API te maken en vervolgens een gegevensbron te koppelen om de gegevens die u hebt gekozen via de API beschikbaar te maken. Fabric bouwt automatisch het GraphQL-schema op basis van uw gegevens en toepassingen zijn binnen enkele minuten klaar om verbinding te maken.

Vereisten

Een API voor GraphQL maken

Een API maken voor GraphQL:

  1. Selecteer Nieuw item in een werkruimte. Selecteer in het deelvenster dat wordt geopend, onder Gegevens ontwikkelen, de API voor GraphQL.

    Schermopname van de werkbalk van de werkruimte, waarin wordt weergegeven waar u de optie Nieuw kunt selecteren.

  2. Voer een naam in voor uw item en selecteer Maken.

    Schermopname van het dialoogvenster Nieuwe API voor GraphQL, waarin wordt weergegeven waar u de naam moet invoeren en maken selecteert.

U hebt nu een volledig functionele API voor toegang tot uw gegevens in Fabric.

Verbinding maken met een gegevensbron en uw schema bouwen

Op dit moment is de API gereed, maar er worden geen gegevens weergegeven. API's voor GraphQL worden gedefinieerd in een schema dat is ingedeeld in termen van typen en velden, in een sterk getypt systeem. Fabric genereert automatisch het benodigde GraphQL-schema op basis van de gegevens die u kiest om beschikbaar te maken voor GraphQL-clients.

  1. Kies in uw nieuwe API een gegevensbron die u beschikbaar wilt maken door gegevensbron selecteren te kiezen.

    Schermopname van de optie Gegevensbron selecteren.

  2. Selecteer vervolgens de connectiviteitsoptie voor uw API:

    Schermopname van de optie Verbinding kiezen.

    Hier kunt u definiëren hoe API-clients toegang hebben tot de API om GraphQL-aanvragen uit te voeren op basis van twee verschillende opties:

    • Eenmalige aanmelding (SSO): gebruik clientreferenties om verbinding te maken met gegevensbronnen. Dit betekent dat de geverifieerde API-gebruiker toegang moet hebben tot de onderliggende gegevensbron. Als u bijvoorbeeld Lakehouse-gegevens beschikbaar wilt maken voor uw API-clients, moet de geverifieerde gebruiker toegang hebben tot zowel de API als het Lakehouse. Meer specifiek machtigingen uitvoeren voor de GraphQL-API (optie Query's en Mutaties uitvoeren bij het toevoegen van machtigingen voor directe toegang) en lees- of schrijfmachtigingen die vereist zijn in de gegevensbron van de keuze dienovereenkomstig. U kunt de gebruiker ook toevoegen als werkruimtelid met een rol inzender , waarbij zowel de API- als gegevensbronitems zich bevinden, waardoor de vereiste toegang tot beide items vanaf één locatie wordt geboden. Zie Gebruikers toegang geven tot werkruimten voor meer informatie.
    • Opgeslagen referenties: gebruik opgeslagen referenties om verbinding te maken met gegevensbronnen, wat betekent dat de geverifieerde API-gebruiker geen directe toegang tot de gegevensbron nodig heeft. Een opgeslagen referentie wordt gedeeld voor toegang tot de gegevens tussen de API en onderliggende tabellen in de gegevensbron. Als u bijvoorbeeld Lakehouse-gegevens beschikbaar maakt voor uw API-clients, hoeft de geverifieerde gebruiker alleen directe toegang te hebben tot de API (optie Query's en Mutaties uitvoeren bij het toevoegen van machtigingen voor directe toegang) en niet het Lakehouse. Er wordt een opgeslagen referentie gebruikt om de API te verbinden met de gegevensbron en wordt gedeeld door alle geverifieerde API-gebruikers. Deze optie is vereist als u een Azure-gegevensbron zoals een Azure SQL-database beschikbaar maakt via GraphQL. Nadat u OK hebt geselecteerd, wordt u gevraagd een nieuwe opgeslagen referentie te maken nadat u in de volgende stap een gegevensbron hebt gekozen als er nog geen opgeslagen referentie voor deze referentie aanwezig is.

    Zodra deze opties zijn geselecteerd, worden deze afgedwongen voor alle gegevensbronnen die vervolgens aan de API zijn toegevoegd. Het is niet mogelijk om eenmalige aanmelding en opgeslagen referenties in dezelfde API te combineren. Bovendien kunt u USER Principal Names (UPN's) of SPN's (Service Principal Names) gebruiken om verbinding te maken met uw API, maar service-principals ondersteunen momenteel alleen eenmalige aanmelding (SSO). Gebruikers-principals kunnen gebruikmaken van eenmalige aanmelding of opgeslagen referenties, afhankelijk van uw beveiligingsvereisten.

    Notitie

    API voor GraphQL vereist dat clienttoepassingen Microsoft Entra gebruiken voor verificatie. Uw clienttoepassing moet voldoende zijn geregistreerd en geconfigureerd om API-aanroepen uit te voeren op Basis van Fabric. Voor de app die is geregistreerd in Microsoft Entra, zijn Item.Execute.All API-machtigingen vereist voor de Power BI-service. U vindt een end-to-end-zelfstudie met instructies en voorbeeldcode voor zowel gebruikers-principals als service-principals bij Connect Applications.

  3. De OneLake-gegevenshub wordt weergegeven; kies de gegevensbron waarmee u verbinding wilt maken. Voor het volgende voorbeeld kiezen we een AdventureWorks SQL-analyse-eindpunt dat is gekoppeld aan een gespiegelde database. Selecteer Filter om alleen specifieke typen Fabric-gegevensbronnen weer te geven of zoek op een specifiek trefwoord. Wanneer u klaar bent, selecteert u Verbinding maken.

    Schermopname van de OneLake-gegevenshub, met beschikbare opties voor gegevensbronnen voor een werkruimte.

  4. Het scherm Gegevens ophalen wordt weergegeven, waarin u kunt kiezen welke objecten u wilt weergeven in uw GraphQL-schema.

    Schermopname van het scherm Gegevens ophalen met de lijst Gegevens kiezen.

  5. Schakel de selectievakjes in naast de afzonderlijke tabellen of opgeslagen procedures die u in de API wilt weergeven. Als u alle objecten in een map wilt selecteren, schakelt u het selectievakje in met de naam van de gegevensbron bovenaan.

    Schermopname van de lijst Gegevens kiezen met een geselecteerde map, waarmee automatisch alle items in die map worden geselecteerd.

  6. Selecteer Laden om het proces voor het genereren van het GraphQL-schema te starten.

  7. Het schema wordt gegenereerd en u kunt beginnen met het maken van prototypen van GraphQL-query's (lezen, vermelden) of mutaties (maken, bijwerken, verwijderen) om met uw gegevens te communiceren.

    Schermopname van het scherm Schemaverkenner.

Uw API voor GraphQL is nu klaar om verbindingen en aanvragen te accepteren. U kunt de API-editor gebruiken om GraphQL-query's en schemaverkenner te testen en te prototypen om de gegevenstypen en velden te controleren die in de API worden weergegeven.

Overzicht van bevoegdheden

De onderstaande tabel bevat een overzicht van de verschillende ondersteunde permutaties en minimale vereiste machtigingen voor clients die toegang hebben tot de GraphQL-API:

API-aanroeper Connectiviteit van gegevensbron Vereiste GraphQL API-machtigingen Vereiste machtigingen voor gegevensbronnen Entra-app-bereik
User Principal (UPN) Eenmalige aanmelding (SSO) Query's en mutaties uitvoeren op API-niveau De juiste lees-/schrijfmachtigingen die zijn verleend aan de UPN in de gegevensbron Item.Execute.All
Service-principal (SPN) Eenmalige aanmelding (SSO) Query's en mutaties uitvoeren op API-niveau De juiste lees-/schrijfmachtigingen die zijn verleend aan de SPN in de gegevensbron Item.Execute.All
User Principal (UPN) Opgeslagen referenties Query's en mutaties uitvoeren op API-niveau De juiste lees-/schrijfmachtigingen die zijn verleend aan de opgeslagen referentie (verbinding) in de gegevensbron Item.Execute.All
Service-principal (SPN) Opgeslagen referenties Momenteel niet ondersteund Momenteel niet ondersteund Momenteel niet ondersteund

Gerelateerde inhoud