Dela via


Skapa ett API för GraphQL i Infrastrukturresurser och lägg till data

Kommentar

Microsoft Fabric API för GraphQL finns i förhandsversion.

Kom igång med Fabric-API:et för GraphQL genom att skapa ett API och länka sedan en datakälla för att exponera de data som du har valt via API:et. Fabric skapar GraphQL-schemat automatiskt baserat på dina data och program är redo att ansluta på några minuter.

Förutsättningar

  • Fabric Premium- eller utvärderingskapacitet
  • Aktivera klientadministratörsinställningen för API för GraphQL (förhandsversion)

Skapa ett API för GraphQL

Så här skapar du ett API för GraphQL:

  1. I Infrastrukturportalen väljer du Datateknik från arbetsbelastningsväxlaren längst ned i navigeringsfältet. Om du är i infrastrukturresursens hem kan du också välja kortet Datateknik.

    Skärmbild av alternativet Datateknik i arbetsbelastningsväxlaren.

  2. Välj API för GraphQL (förhandsversion).

    Skärmbild av API-panelen som du väljer för att skapa ett nytt API-objekt.

    Du kan också välja Nytt>API för GraphQL (förhandsversion) från valfri arbetsyta i Datateknik.

    Skärmbild av verktygsfältet för arbetsytan som visar var du väljer alternativet Nytt.

  3. Ange ett namn för objektet och välj Skapa.

    Skärmbild av dialogrutan Nytt API för GraphQL som visar var du anger namnet och väljer Skapa.

Nu har du ett fullt fungerande API för att komma åt dina data i Fabric.

Anslut till en datakälla och skapa ditt schema

I det här läget är API:et redo, men det exponerar inga data. API:er för GraphQL definieras i ett schema som är organiserat i form av typer och fält, i ett starkt skrivet system. Fabric genererar automatiskt det nödvändiga GraphQL-schemat baserat på de data som du väljer att exponera för GraphQL-klienter.

  1. I det nya API:et väljer du en datakälla som ska exponeras genom att välja Välj datakälla.

    Skärmbild av alternativet Välj datakälla.

  2. OneLake-datahubben visas. välj den datakälla som du vill ansluta till. I följande exempel väljer vi en AdventureWorks SQL-analysslutpunkt som är länkad till en speglad databas. Välj Filtrera om du bara vill se specifika typer av infrastrukturdatakällor eller söka efter ett specifikt nyckelord. När du är klar väljer du Anslut.

    Skärmbild av OneLake-datahubben som visar tillgängliga alternativ för datakällor för en arbetsyta.

  3. Skärmen Hämta data visas, där du kan välja vilka objekt som ska exponeras i GraphQL-schemat.

    Skärmbild av skärmen Hämta data som visar listan Välj data.

  4. Markera kryssrutorna bredvid de enskilda tabeller eller lagrade procedurer som du vill exponera i API:et. Om du vill markera alla objekt i en mapp markerar du kryssrutan med datakällans namn överst.

    Skärmbild av listan Välj data med en vald mapp, som automatiskt markerar alla objekt i mappen.

  5. Välj Läs in för att starta GraphQL-schemagenereringsprocessen.

  6. Schemat genereras och du kan börja skapa prototyper för GraphQL-frågor (läsa, lista) eller mutationer (skapa, uppdatera, ta bort) för att interagera med dina data.

    Skärmbild av skärmen Schemautforskaren.

Ditt API för GraphQL är nu redo att acceptera anslutningar och begäranden. Du kan använda API-redigeraren för att testa och prototypa GraphQL-frågor och Schemautforskaren för att verifiera de datatyper och fält som exponeras i API:et.