Delen via

Een API voor GraphQL maken in Fabric en gegevens toevoegen

  • Artikel

Notitie

Microsoft Fabric-API voor GraphQL is in preview.

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 in de Fabric-portal Data-engineer ing vanuit de workloadwisselaar onder aan de navigatiebalk. Als u zich in het fabric-huis bevindt, kunt u ook de Data-engineer kaart selecteren.

    Schermopname van de optie Data-engineer in de workloadwisselaar.

  2. Selecteer API voor GraphQL (preview).

    Schermopname van de API-tegel die u selecteert om een nieuw API-item te maken.

    U kunt ook Nieuwe>API voor GraphQL (preview) selecteren in elke werkruimte in Data-engineer ing.

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

  3. 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. 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.

  3. 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.

  4. 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.

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

  6. 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.

Gerelateerde inhoud