Snabbstart: Skapa din första graf i Microsoft Fabric

I den här snabbstarten använder du grafen i Microsoft Fabric för att skapa en grundläggande graf med två noder och en kant och kör sedan en fråga. Den här processen tar cirka 15 minuter.

En omfattande självstudiekurs som beskriver den fullständiga Adventure Works-datamodellen och mer avancerade scenarier finns i graph-självstudien.

Förutsättningar

Innan du startar den här snabbstarten kontrollerar du att:

  1. Du har åtkomst till en Microsoft Fabric-kapacitet (F2 eller senare) eller en fabric-utvärderingsversion.

  2. Graph är tillgängligt i din region.

  3. Du är medlem i en Fabric-arbetsyta eller har behörighet att skapa objekt i arbetsytan. Mer information finns i Arbetsytor i Microsoft Fabric.

    Viktigt!

    Åtkomsthanteringen för grafen är begränsad till den arbetsyta som hyser den. Användare utanför arbetsytan kan inte komma åt diagrammet. Användare på arbetsytan som har åtkomst till underliggande data i lakehouse kan modellera och utföra förfrågningar mot grafen.

Läsa in exempeldata

** För att skapa grafen laddar du först upp exempeldata i ett lakehouse i din Fabric-arbetsyta.

Hämta exempeldata

  1. Gå till diagrammet i Microsoft Fabric GQL-exempeldatauppsättningar på GitHub.

  2. Välj filen adventureworks_docs_sample.zip och ladda ned den till din dator.

    Tips/Råd

    Om du vill ladda ned en fil från GitHub väljer du filen och väljer sedan ikonen Ladda ned råfilen.

  3. Extrahera den nedladdade adventureworks_docs_sample.zip filen till en mapp på den lokala datorn.

    Tips/Råd

    Högerklicka på zip-filen i Utforskaren och välj Extrahera alla och välj sedan en målmapp.

Skapa ett sjöhus

  1. I Microsoft Fabric väljer du den arbetsyta där du vill skapa sjöhuset.
  2. Välj + Nytt objekt.
  3. Välj Lagra data>Lakehouse.
  4. Ange ett namn (till exempel "AdventureWorksLakehouse"), avmarkera alternativet Lakehouse-scheman och välj Skapa.

Ladda in data i tabeller

För den här snabbstarten behöver du bara två tabeller: adventureworks_customers och adventureworks_orders. Ladda upp den fullständiga exempeldatamappen och läs sedan bara in de två tabellerna.

Anmärkning

Den fullständiga uppsättningen exempelfiler används i den fullständiga grafkursen. Du kan också använda dem för att utforska ytterligare data på egen hand.

  1. Hovra över Filer i lakehouse, välj ellipsen (...) och välj sedan Överför>uppladdningsmapp.
  2. Bläddra till den extraherade mappen och ladda upp den. Den här åtgärden laddar upp alla exempeldatafiler till lakehouse.
  3. Expandera Filer och den uppladdade mappen för att se undermapparna. För den här snabbstarten behöver du bara läsa in två av dem som tabeller.
  4. Hovra över adventureworks_customers undermapp, välj ellipsen (...) och välj Läs in till tabeller>Ny tabell.
  5. Ange filtypen till parquet och välj Läs in.
  6. Upprepa steg 4–5 för undermappen adventureworks_orders.

När du är klar visas de två tabellerna under Tabeller i lakehouse Explorer-panelen.

Skärmbild som visar tabellerna adventureworks_customers och adventureworks_orders.

Skapa en grafmodell

  1. I din Microsoft Fabric arbetsyta väljer du + Nytt objekt.

  2. Ange graf i sökrutan, tryck på Retur för att söka efter diagramobjekt och välj Graph-instans. Du kan också rulla ned till Analysera och träna data>Graph-instansen.

    Skärmbild som visar den nya objektmenyn med alternativet att välja Graph-modell.

  3. Ange ett namn för grafmodellen, till exempel AdventureWorksGraph, och välj Skapa.

När du har skapat grafmodellen tas du till grafvyn där du kan se att standardläget är inställt på Modell. I de översta menyflikarna visas knappar för Spara, Hämta data, Lägg till nod, Lägg till kant och Ta bort.

Skärmbild som visar standardvyn för grafmodellen.

Lägga till data i diagrammet

Följ dessa steg i grafvyn om du vill lägga till data i diagrammet:

  1. I det övre menyfliksområdet väljer du Hämta data.

  2. I OneLake-katalogen väljer du ditt lakehouse med Adventure Works-data.

  3. Välj Lägg till.

  4. Välj tabellerna adventureworks_customers och adventureworks_orders och välj sedan Läs in.

    Skärmbild som visar dialogrutan hämta data med valda tabeller.

Definiera grafens struktur

Nu när dina data har lästs in definierar du grafens struktur genom att lägga till noder och kanter. I den här snabbstarten lägger du till två nodtyper (Customer och Order) och en kanttyp (purchases) för att modellera relationen mellan kunder och deras beställningar.

Lägga till två noder

  1. I det övre menyfliksområdet väljer du Lägg till nod.

  2. Konfigurera den första noden:

    • Nodetikett: Customer
    • Källtabell: adventureworks_customers
    • Nyckel: CustomerID_K

    Skärmbild som visar dialogrutan Lägg till nod i grafen.

  3. Välj + Lägg till egenskap, Lägg till alla kolumner och Använd. Det här steget gör alla kolumner i den här källtabellen tillgängliga som egenskaper för noden.

    Skärmbild som visar dialogrutan Lägg till nod i grafen med fyra egenskaper.

  4. Välj Skapa. Du ser en nod för Customer som visas på grafarbetsytan.

  5. Välj Lägg till nod igen.

  6. Konfigurera den andra noden:

    • Nodetikett: Order
    • Källtabell: adventureworks_orders
    • Nyckel: SalesOrderDetailID_K
  7. Välj + Lägg till egenskap, Lägg till alla kolumner och Använd. Det här steget gör alla kolumner i den här källtabellen tillgängliga som egenskaper för noden.

  8. Välj Skapa.

Nu har du två noder Customer och Order, synliga på grafarbetsytan.

Skärmbild som visar två nya noder på arbetsytan.

Lägg till en kant

  1. I det övre menyfliksområdet väljer du Lägg till kant.

  2. Konfigurera gränsen:

    • Edge-etikett: purchases
    • Källtabell: adventureworks_orders
    • Ursprungsnod: Customer
    • Ursprungsnyckel: CustomerID_FK
    • Målnod: Order
    • Målnyckel: SalesOrderDetailID_K

    Skärmbild som visar dialogrutan Lägg till kant.

  3. Välj + Lägg till egenskap, Lägg till alla kolumner och Använd. Det här steget gör alla kolumner i den här källtabellen tillgängliga som egenskaper för gränsen.

  4. Välj Skapa.

  5. I det övre menyfliksområdet väljer du Spara.

Du ser nod- och kantetiketterna på grafvyns rityta.

Skärmbild som visar den nya gränsen mellan de två noderna på arbetsytan.

Det kan ta några minuter innan data läses in. Vänta tills datainläsningen pågår för att visa att datainläsningen har slutförts... innan du fortsätter till nästa avsnitt.

Skärmbild som visar bekräftelsemeddelandet om att datainläsningen har slutförts.

Utför en sökning i grafen

Kör en GQL-fråga för att hitta de fem främsta kunderna efter orderantal.

  1. I panelen Lägen väljer du Frågeläge .

  2. I det övre menyfliksområdet väljer du Frågeverktygets kodredigerare>.

    Skärmbild som visar hur du väljer frågeläge och kodredigeraren.

  3. Ange följande GQL-fråga i indatarutan:

    MATCH (c:Customer)-[:purchases]->(o:`Order`)
    RETURN c.fullName AS customer_name, count(o) AS num_orders
    GROUP BY customer_name
    ORDER BY num_orders DESC
    LIMIT 5
    
  4. I det övre menyfliksområdet väljer du Kör fråga. Du ser fem rader med kundnamn och deras orderantal, sorterade från de flesta till minst antal beställningar.

    Skärmbild som visar resultatet av att köra en GQL-fråga.

Grattis! Du skapade din första graf i Microsoft Fabric och körde en fråga mot den.

Nästa steg