Snelstartgids voor Graph in Microsoft Fabric

Opmerking

Deze functie is momenteel beschikbaar als openbare preview-versie. Deze preview wordt geleverd zonder een service level agreement en wordt niet aanbevolen voor productieworkloads. Bepaalde functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden. Voor meer informatie, zie Aanvullende Gebruiksvoorwaarden voor Microsoft Azure Previews.

In deze quickstart leert u hoe u een grafiekmodel maakt in Microsoft Fabric.

Belangrijk

In dit artikel wordt uitsluitend gebruikgemaakt van de voorbeeldgrafiekgegevensset AdventureWorks.

Vereiste voorwaarden

Om aan de slag te gaan met graph in Microsoft Fabric, hebt u de volgende vereisten nodig:

• Grafiek is beschikbaar in uw regio.

• De grafiek is ingeschakeld in uw Fabric-tenant.

  

• Een lakehouse in OneLake met gegevens die u wilt analyseren. In deze quickstart worden Adventure Works-gegevens als voorbeeld gebruikt. Uw gegevens en resultaten kunnen verschillen. Als u geen lakehouse hebt, maakt u er een door deze stappen te volgen: Een lakehouse maken met OneLake.

  Belangrijk

  U kunt geen lakehouse gebruiken waarvoor lakehouse-schema (preview) is ingeschakeld.

• U bent lid van een werkruimte of bent gemachtigd om items in de werkruimte te maken. Zie Werkruimten in Microsoft Fabric voor meer informatie.

  Belangrijk

  Toegangsbeheer van de grafiek is beperkt tot de werkruimte waarop deze wordt gehost. De grafiek is niet toegankelijk voor gebruikers buiten de werkruimte. Gebruikers in de werkruimte die toegang hebben tot de onderliggende gegevens in lakehouse, kunnen de grafiek modelleren en er query's op uitvoeren.

Een grafiekmodel maken

Graph in Microsoft Fabric gebruikt dezelfde werkruimterollen als andere Microsoft Fabric-items. De volgende tabel bevat een overzicht van de machtigingen die zijn gekoppeld aan de mogelijkheden van elke Microsoft Fabric-werkruimterol voor grafiekmodellen.

Vermogen	beheerder	Lid	Donateur	Kijker
Grafiekmodel maken of wijzigen	✔	✔	✔	✖
Grafiekmodel verwijderen	✔	✔	✔	✖
Inhoud van grafiekmodel weergeven en lezen	✔	✔	✔	✔
Grafiekmodel delen	✔	✔	✖	✖

Voer de volgende stappen uit om een grafiekmodel te maken in Microsoft Fabric:

1. Ga naar uw Microsoft Fabric-werkruimte.

2. Selecteer + Nieuw item.

3. Selecteer Gegevens analyseren en trainen>Grafiekmodel (voorvertoning).

   

   Aanbeveling

   U kunt ook 'grafiek' invoeren in het zoekvak en op Enter drukken om te zoeken naar grafiekitems.

4. Voer een naam in voor uw grafiekmodel en selecteer Maken.

Een grafiek maken

In de grafiekweergave ziet u De knoppen Opslaan, Knooppunt toevoegen en Edge toevoegen en Gegevens ophalen .

Volg deze stappen om een grafiek te maken in Microsoft Fabric:

1. Selecteer Gegevens ophalen in uw grafiekmodel.

2. Selecteer in de OneLake-catalogus gegevens uit Fabric die u in uw grafiek wilt gebruiken.

   

   Opmerking

   In deze quickstart worden Adventure Works-gegevens als voorbeeld gebruikt. Uw gegevensset en resultaten kunnen verschillen.

3. Selecteer vervolgens Connect.

4. Selecteer gegevenstabellen en vervolgens Laden.

5. U ziet nu gegevens die beschikbaar zijn voor gebruik in uw grafiek.

   

   Opmerking

   Graph in Microsoft Fabric ondersteunt momenteel de volgende gegevenstypen:

   • Booleaanse waarde (waarden zijn true en false)
   • Double (waarden zijn 64-bits drijvende-komma getallen)
   • Geheel getal (waarden zijn 64-bits gesigneerde gehele getallen)
   • Tekenreeks (waarden zijn Unicode-tekenreeksen)
   • Zoned DateTime (waarden zijn tijdstempels samen met een tijdverschuiving voor de tijdzone)

Modellering starten

U kunt nu beginnen met modelleren door knooppunten en randen toe te voegen aan de grafiek. We gebruiken het gegevensmodel Adventure Works als voorbeeld.

Knooppunten toevoegen

In deze sectie maken we knooppunten voor elke entiteit in het Adventure Works-gegevensmodel.

Knooppuntlabel	Toewijzingstabel	Toewijzingskolom
Customer	customers	CustomerID_K
Bestelling	orders	SalesOrderDetailID_K
Werknemer	employees	EmployeeID_K
Product	products	ProductID_K
ProductCategory	productcategorieën	CategoryID_K
ProductSubcategory	productsubcategorieën	SubcategoryID_K
Leverancier	vendors	VendorID_K

Voer de volgende stappen uit om de knooppunten toe te voegen aan uw grafiek:

1. Selecteer In uw grafiekmodel het knooppunt Toevoegen om een nieuw knooppunt toe te voegen aan uw grafiek.

2. Voer in het dialoogvenster Toevoegen aan grafiek een labelnaam in en selecteer de juiste toewijzingstabel en toewijzingskolom.

   

   In dit voorbeeld is het knooppuntlabel 'Klant', de mappingstabel 'klanten' en de mappingkolom 'CustomerID_K'.

3. Selecteer Bevestigen om het knooppunt toe te voegen aan uw grafiek.

4. Herhaal het proces voor alle andere knooppunten. U ziet nu alle knooppunten die in uw grafiek worden weergegeven.

5. Selecteer Opslaan om te beginnen met het genereren van uw grafiek.

   

Randen toevoegen

In deze sectie maken we randen om de relaties tussen de knooppunten in het gegevensmodel Adventure Works te definiëren.

Edge	Toewijzingstabel	Kolom voor toewijzing van bronknooppunten	Kolom doelknooppunttoewijzing
Verkoopt	orders	Werknemer EmployeeID_FK	Bestelling SalesOrderDetailID_K
Aankopen	orders	Customer CustomerID_FK	Bestelling SalesOrderDetailID_K
bevat	orders	Bestelling SalesOrderDetailID_K	Product ProductID_FK
isOfType	products	Product ProductID_K	ProductSubCategory SubcategoryID_FK
behoort tot	productsubcategorieën	ProductSubCategory SubcategoryID_K	ProductCategory CategoryID_FK
Produceert	leverancierproduct	Leverancier VendorID_FK	Product ProductID_FK

Voer de volgende stappen uit om de randen aan uw grafiek toe te voegen:

1. Selecteer Edge toevoegen om een relatie tussen knooppunten te maken.

2. Selecteer in het dialoogvenster Edge toevoegen de toewijzingstabel, bron- en doelknooppunten en definieer de relatie.

   

   In dit voorbeeld wordt de rand gedefinieerd als 'verkoopt' met de toewijzingstabel 'orders', waarmee het bronknooppunt Werknemer (EmployeeID_FK) wordt verbonden met het doelknooppunt 'Order' (SalesOrderDetailID_K).

3. Selecteer Bevestigen om de rand aan uw grafiek toe te voegen.

4. Herhaal het proces voor alle andere randen. U zou alle randen moeten zien die in uw graf worden weergegeven.

   

Op dit punt hebt u alle knooppunten en randen voor uw grafiek gemaakt. Dit is de basisstructuur van uw grafiekmodel.

De grafiek laden

Als u de grafiek wilt laden, selecteert u Opslaan. Hiermee controleert u het grafiekmodel, laadt u gegevens uit OneLake, maakt u de grafiek en maakt u deze klaar voor het uitvoeren van query's.

Belangrijk

U moet de grafiek momenteel opnieuw laden (door Opslaan te selecteren) wanneer het model of de onderliggende gegevens worden gewijzigd.

Query's uitvoeren op de grafiek

Graph in Microsoft Fabric gebruikt dezelfde werkruimterollen als andere Microsoft Fabric-items. De volgende machtigingen voor werkruimterollen zijn van toepassing, afhankelijk van of u query's uitvoert via het Graph Model- of QuerySet-item.

Machtigingen voor werkruimterollen voor Graph Model

Vermogen	beheerder	Lid	Donateur	Kijker
Grafiekmodel maken of wijzigen	✔	✔	✔	✖
Grafiekmodel verwijderen	✔	✔	✔	✖
Inhoud van grafiekmodel weergeven en lezen	✔	✔	✔	✔
Grafiekmodel delen	✔	✔	✖	✖
Grafiekquery's maken of wijzigen	✔	✔	✔	✖
Grafiek QuerySet-item maken of wijzigen	✔	✔	✔	✖

Machtigingen voor rollen in de werkruimte voor Graph QuerySet

Vermogen	beheerder	Lid	Donateur	Kijker
Grafiek QuerySet-item maken of wijzigen	✔	✔	✔	✖
QuerySet-item verwijderen	✔	✔	✔	✖
Inhoud van querysetitem weergeven en lezen	✔	✔	✔	✔
Verbinding maken met graafinstantie	✔	✔	✔	✖
QuerySet delen	✔	✔	✖	✖

Opmerking

Alle gebruikers hebben leestoegang nodig tot het onderliggende grafieksinstantie-item om query's uit te voeren op de gerefereerde grafieksinstantie van het Graph QuerySet-item. Alleen machtigingen voor lezen, schrijven en opnieuw delen worden ondersteund voor het QuerySet-item.

De opbouwfunctie voor query's gebruiken

We kunnen nu een query uitvoeren op de grafiek door specifieke knooppunten en relaties te selecteren. Alle query's zijn gebaseerd op de grafiekstructuur die we in de vorige sectie hebben gemaakt.

Volg deze stappen om over te schakelen naar de opbouwfunctie voor query's en om interactief query's uit te voeren op uw grafiek:

1. Selecteer Modi's querybouwer> op de startpagina van uw grafiek. In deze weergave kunt u ook een alleen-lezen queryset maken, die dezelfde functies heeft als hieronder en waarmee u uw queryresultaten kunt delen.

2. Selecteer Knooppunt toevoegen om de beschikbare knooppunten te bekijken voor het uitvoeren van query's.

3. Selecteer een knooppunt om het toe te voegen aan uw query. In dit voorbeeld voegen we het knooppunt Klant toe.

   

4. Hier kunt u uw query bouwen door knooppunten en randen toe te voegen, filters toe te passen en eigenschappen te selecteren die moeten worden geretourneerd in de resultaten.

De code-editor gebruiken

We kunnen ook query's uitvoeren op de grafiek met behulp van de GQL-grafiekquerytaal.

Volg deze stappen om over te schakelen naar de code-editor en een query uit te voeren op uw grafiek met behulp van GQL:

1. Selecteer Modi>Code-editor vanaf de startpagina van uw grafiek.
2. Voer een GQL-query in het invoerveld in, zoals MATCH (n:`Order`) RETURN count(n) AS num_orders.
3. Selecteer Query uitvoeren om de query uit te voeren.

U kunt ook complexere query's uitvoeren, zoals query's die overeenkomende grafiekpatronen combineren, filteren, aggregatie, sorteren en boven-k beperken:

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

Raadpleeg de GQL-taalhandleiding voor meer informatie over GQL-taalondersteuning.

Verwante inhoud

• GQL-taalhandleiding
• GQL beknopte handleiding
• Microsoft Fabric gratis uitproberen
• End-to-end handleidingen in Microsoft Fabric