Snabbstartsguide för Graph i Microsoft Fabric

Anmärkning

Den här funktionen är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och rekommenderas inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.

I den här snabbstarten får du lära dig hur du skapar en grafmodell i Microsoft Fabric.

Viktigt!

Den här artikeln använder endast AdventureWorks exempeldiagramdatauppsättning.

Förutsättningar

För att komma igång med graph i Microsoft Fabric behöver du följande förutsättningar:

• Graph är tillgängligt i din region.

• Graph är aktiverat i Fabric-klientorganisationen.

  

• Ett sjöhus i OneLake med data som du vill analysera. Den här snabbstarten använder Adventure Works-data som exempel. Dina data och resultat kan skilja sig åt. Om du inte har ett sjöhus skapar du ett genom att följa dessa steg: Skapa ett sjöhus med OneLake.

  Viktigt!

  Du kan inte använda ett lakehouse som har lakehouse-schema (förhandsversion) aktiverat.

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

  Viktigt!

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

Skapa en grafmodell

Graph i Microsoft Fabric använder samma arbetsyteroller som andra Microsoft Fabric-objekt. I följande tabell sammanfattas de behörigheter som är associerade med varje Microsoft Fabric-arbetsyterolls kapacitet för grafmodeller.

Capability	Admin	Medlem	Bidragsgivare	Åskådare
Skapa eller ändra grafmodell	✔	✔	✔	✖
Ta bort grafmodell	✔	✔	✔	✖
Visa och läsa innehåll i grafmodellen	✔	✔	✔	✔
Dela grafmodell	✔	✔	✖	✖

Följ dessa steg för att skapa en grafmodell i Microsoft Fabric:

1. Gå till din Microsoft Fabric-arbetsyta.

2. Välj + Nytt objekt.

3. Välj Analysera och träna data>Graphmodell (förhandsversion).

   

   Tips/Råd

   Du kan också ange "graf" i sökrutan och trycka på Retur för att söka efter diagramobjekt.

4. Ange ett namn på grafmodellen och välj Skapa.

Skapa ett diagram

I grafvyn bör du se knapparna Spara, Lägg till nod och Lägg till kant och Hämta data .

Följ dessa steg för att skapa ett diagram i Microsoft Fabric:

1. I grafmodellen väljer du Hämta data.

2. I OneLake-katalogen väljer du data från Fabric som ska användas i grafen.

   

   Anmärkning

   Den här snabbstarten använder Adventure Works-data som exempel. Datamängden och resultaten kan skilja sig åt.

3. Välj sedan Anslut.

4. Välj datatabeller och välj sedan Läs in.

5. Du bör se tillgängliga data för användning i diagrammet.

   

   Anmärkning

   Graph i Microsoft Fabric stöder för närvarande följande datatyper:

   • Booleskt värde (värden är true och false)
   • Dubbel (värden är 64-bitars flyttalsnummer)
   • Heltal (värden är 64-bitars signerade heltal)
   • Sträng (värden är Unicode-teckensträngar)
   • Zoned DateTime (värden är tidsstämplar tillsammans med en tidsförskjutning för tidszonen)

Börja modellering

Nu kan du börja modellera genom att lägga till noder och kanter i diagrammet. Vi använder Datamodellen Adventure Works som exempel.

Lägga till noder

I det här avsnittet skapar vi noder för varje entitet i Adventure Works-datamodellen.

Nodetikett	Kartläggningstabell	Mappningskolumn
Kund	customers	CustomerID_K
Beställning	orders	SalesOrderDetailID_K
Medarbetare	employees	EmployeeID_K
Produkt	products	ProductID_K
Produktkategori	Produktkategorier	CategoryID_K
Produktunderkategori	produktunderkategorier	SubcategoryID_K
Leverantör	vendors	VendorID_K

Följ dessa steg för att lägga till noderna i diagrammet:

1. I grafmodellen väljer du Lägg till nod för att lägga till en ny nod i diagrammet.

2. I dialogrutan Lägg till nod i grafen anger du ett etikettnamn och väljer lämplig mappningstabell och mappningskolumn.

   

   I det här exemplet är nodetiketten "Kund", mappningstabellen är "kunder" och mappningskolumnen är "CustomerID_K".

3. Välj Bekräfta för att lägga till noden i diagrammet.

4. Upprepa processen för alla andra noder. Du bör se alla noder som visas i diagrammet.

5. Välj Spara för att börja generera diagrammet.

   

Lägg till kanter

I det här avsnittet skapar vi kanter för att definiera relationerna mellan noderna i Adventure Works-datamodellen.

Edge	Kartläggningstabell	Kolumn för källnodmappning	Mappningskolumn för målnod
Säljer	orders	Medarbetare EmployeeID_FK	Beställning SalesOrderDetailID_K
Inköp	orders	Kund CustomerID_FK	Beställning SalesOrderDetailID_K
contains	orders	Beställning SalesOrderDetailID_K	Produkt ProductID_FK
isOfType	products	Produkt ProductID_K	ProduktUnderkategori SubcategoryID_FK
tillhör	produktunderkategorier	ProduktUnderkategori SubcategoryID_K	Produktkategori CategoryID_FK
Producerar	leverantörsprodukt	Leverantör VendorID_FK	Produkt ProductID_FK

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

1. Välj Lägg till kant för att skapa en relation mellan noder.

2. I dialogrutan Lägg till kant väljer du mappningstabellen, käll- och målnoderna och definierar relationen.

   

   I det här exemplet definieras gränsen som "säljer" med mappningstabellen "orders" och ansluter källnoden "Employee" (EmployeeID_FK) till målnoden "Order" (SalesOrderDetailID_K).

3. Välj Bekräfta för att lägga till kanten i diagrammet.

4. Upprepa processen för alla andra kanter. Du bör se alla kanter som visas i diagrammet.

   

Nu har du skapat alla noder och kanter för diagrammet. Det här är den grundläggande strukturen för grafmodellen.

Läs in grafen

Om du vill läsa in diagrammet väljer du Spara. Detta verifierar grafmodellen, läser in data från OneLake, konstruerar grafen och förbereder den för frågor.

Viktigt!

För närvarande måste du läsa in grafen igen (genom att välja Spara) när modellen eller underliggande data ändras.

Förfråga grafen

Graph i Microsoft Fabric använder samma arbetsyteroller som andra Microsoft Fabric-objekt. Följande behörigheter för arbetsytans roll gäller beroende på om du kör frågor via Graph Model eller QuerySet-objektet.

Rollbehörigheter för Graph Model-arbetsyta

Capability	Admin	Medlem	Bidragsgivare	Åskådare
Skapa eller ändra grafmodell	✔	✔	✔	✖
Ta bort grafmodell	✔	✔	✔	✖
Visa och läsa innehåll i grafmodellen	✔	✔	✔	✔
Dela grafmodell	✔	✔	✖	✖
Skapa eller ändra graffrågor	✔	✔	✔	✖
Skapa eller ändra grafobjekt i queryset	✔	✔	✔	✖

Rollbehörigheter för arbetsyta för Graph QuerySet

Capability	Admin	Medlem	Bidragsgivare	Åskådare
Skapa eller ändra grafobjekt i queryset	✔	✔	✔	✖
Ta bort QuerySet-objekt	✔	✔	✔	✖
Visa och läsa innehållet i QuerySet-objekt	✔	✔	✔	✔
Ansluta till graph-instans	✔	✔	✔	✖
Dela frågeuppsättning	✔	✔	✖	✖

Anmärkning

Alla användare behöver läsåtkomst till det underliggande grafinstansobjektet för att köra frågor mot den refererade grafinstansen från diagrammet QuerySet-objektet. Endast läs-, skriv- och omdelningsbehörigheter stöds för QuerySet-objekt.

Använda frågeverktyget

Nu kan vi fråga grafen genom att välja specifika noder och relationer. Alla frågor baseras på grafstrukturen som vi skapade i föregående avsnitt..

Följ de här stegen för att växla till frågeverktyget och börja fråga diagrammet interaktivt:

1. Välj Lägen>Frågebyggare från diagrammets förstasida. I den här vyn kan du också skapa en skrivskyddad frågeuppsättning som har samma funktioner som nedan och som gör att du kan dela dina frågeresultat.

2. Välj Lägg till nod för att se tillgängliga noder för frågor.

3. Välj en nod för att lägga till den i din fråga. I det här exemplet lägger vi till noden Kund .

   

4. Härifrån kan du skapa din fråga genom att lägga till noder och kanter, tillämpa filter och välja egenskaper som ska returneras i resultatet.

Använda kodredigeraren

Vi kan också köra frågor mot grafen med frågespråket GQL-graf.

Följ dessa steg för att växla till kodredigeraren och börja köra frågor mot diagrammet med hjälp av GQL:

1. Välj Lägen>Kodredigerare från diagrammets startsida.
2. Ange en GQL-fråga i indatafältet, till exempel MATCH (n:`Order`) RETURN count(n) AS num_orders.
3. Välj Kör fråga för att köra frågan.

Du kan också köra mer komplexa frågor, till exempel frågor som kombinerar matchande grafmönster, filtrering, aggregering, sortering och topp-k-begränsning:

MATCH (v:Vendor)-[:produces]->(p:`Product`)->(sc:`ProductSubcategory`)->(c:`ProductCategory`), 
      (o:`Order`)-[:`contains`]->(p)
FILTER c.categoryName = 'Components'
LET vendorName = v.vendorName, subCategoryName = sc.subCategoryName
RETURN vendorName, subCategoryName, count(p) AS num_products, count(o) AS num_orders
GROUP BY vendorName, subCategoryName
ORDER BY num_orders DESC
LIMIT 5

Mer information om stöd för GQL-språk finns i GQL-språkguiden.

Relaterat innehåll

• Språkguide för GQL
• GQL-förkortad referens
• Prova Microsoft Fabric kostnadsfritt
• Handledningar från början till slut i Microsoft Fabric