Schnellstarthandbuch für Graph in Microsoft Fabric

Hinweis

Dieses Feature ist zurzeit als öffentliche Preview verfügbar. Diese Vorschauversion wird ohne Vereinbarung zum Servicelevel bereitgestellt und ist nicht für Produktionsworkloads vorgesehen. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.

In dieser Schnellstartanleitung erfahren Sie, wie Sie ein Diagrammmodell in Microsoft Fabric erstellen.

Von Bedeutung

In diesem Artikel wird ausschließlich das Beispiel-Diagramm-Dataset "AdventureWorks" verwendet.

Voraussetzungen

Um mit Graph in Microsoft Fabric zu beginnen, benötigen Sie die folgenden Voraussetzungen:

• Graph ist in Ihrer Region verfügbar.

• Graph ist in Ihrem Fabric-Mandanten aktiviert:

  

• Ein Seehaus in OneLake mit Daten, die Sie analysieren möchten. In dieser Schnellstartanleitung werden Adventure Works-Daten als Beispiel verwendet. Ihre Daten und Ergebnisse können unterschiedlich sein. Wenn Sie kein Seehaus haben, erstellen Sie eins mit den folgenden Schritten: Erstellen Sie ein Seehaus mit OneLake.

  Von Bedeutung

  Sie können kein Lakehouse verwenden, bei dem das Lakehouse-Schema (Vorschau) aktiviert ist.

• Sie sind Mitglied eines Arbeitsbereichs oder verfügen über die Berechtigung zum Erstellen von Elementen im Arbeitsbereich. Weitere Informationen finden Sie unter Arbeitsbereiche in Microsoft Fabric.

  Von Bedeutung

  Die Zugriffsverwaltung des Diagramms ist auf den Arbeitsbereich beschränkt, in dem es gehostet wird. Auf das Diagramm kann nicht für Benutzer außerhalb des Arbeitsbereichs zugegriffen werden. Benutzer innerhalb des Arbeitsbereichs, die Zugriff auf die zugrunde liegenden Daten im Seehaus haben, können das Diagramm modellieren und abfragen.

Erstellen eines Diagrammmodells

Graph in Microsoft Fabric verwendet dieselben Arbeitsbereichsrollen wie andere Microsoft Fabric-Elemente. In der folgenden Tabelle sind die Berechtigungen zusammengefasst, die den Funktionen der einzelnen Microsoft Fabric-Arbeitsbereichsrollen für Diagrammmodelle zugeordnet sind.

Fähigkeit	Administrator	Mitglied	Beitragender	Viewer
Erstellen oder Ändern des Diagrammmodells	✔	✔	✔	✖
Diagrammmodell löschen	✔	✔	✔	✖
Anzeigen und Lesen von Inhalten des Diagrammmodells	✔	✔	✔	✔
Diagrammmodell freigeben	✔	✔	✖	✖

Führen Sie die folgenden Schritte aus, um ein Diagrammmodell in Microsoft Fabric zu erstellen:

1. Wechseln Sie zu Ihrem Microsoft Fabric-Arbeitsbereich.

2. Wählen Sie + Neues Element aus.

3. Wählen Sie "Daten analysieren und trainieren>"Graphmodell (Vorschau) aus.

   

   Tipp

   Geben Sie alternativ "Graph" in das Suchfeld ein, und drücken Sie die EINGABETASTE , um nach Diagrammelementen zu suchen.

4. Geben Sie einen Namen für Ihr Diagrammmodell ein, und wählen Sie "Erstellen" aus.

Erstellen eines Diagramms

In der Diagrammansicht sollte " Speichern", "Knoten hinzufügen" und "Rand hinzufügen" und " Datenschaltflächen abrufen " angezeigt werden.

Führen Sie die folgenden Schritte aus, um ein Diagramm in Microsoft Fabric zu erstellen:

1. Wählen Sie im Diagrammmodell "Daten abrufen" aus.

2. Wählen Sie im OneLake-Katalog Daten aus Fabric aus, die in Ihrem Diagramm verwendet werden sollen.

   

   Hinweis

   In dieser Schnellstartanleitung werden Adventure Works-Daten als Beispiel verwendet. Ihre Datensätze und Ergebnisse können unterschiedlich sein.

3. Wählen Sie dann Verbinden aus.

4. Wählen Sie Datentabellen und dann "Laden" aus.

5. Es sollten Daten angezeigt werden, die für die Verwendung in Ihrem Diagramm verfügbar sind.

   

   Hinweis

   Graph in Microsoft Fabric unterstützt derzeit die folgenden Datentypen:

   • Boolescher Wert (Werte sind true und false)
   • Double (Werte sind 64-Bit-Gleitkommazahlen)
   • Ganzzahl (Werte sind 64-Bit vorzeichenbehaftete Ganzzahlen)
   • Zeichenfolge (Werte sind Unicode-Zeichenzeichenfolgen)
   • Zoned DateTime (Werte sind Zeitstempel zusammen mit einer Zeitverschiebung für die Zeitzone)

Modellieren beginnen

Jetzt können Sie mit der Modellierung beginnen, indem Sie dem Diagramm Knoten und Kanten hinzufügen. Wir verwenden das Adventure Works-Datenmodell als Beispiel.

Hinzufügen von Knoten

In diesem Abschnitt erstellen wir Knoten für jede Entität im Adventure Works-Datenmodell.

Knotenbezeichnung	Zuordnungstabelle	Zuordnungsspalte
Customer	customers	CustomerID_K
Bestellung	orders	SalesOrderDetailID_K
Mitarbeiter	employees	MitarbeiterID_K
Produkt	products	ProductID_K
Produktkategorie	Produktkategorien	CategoryID_K
Produktunterkategorie	Produktunterkategorien	SubcategoryID_K
Hersteller	vendors	VendorID_K

Führen Sie die folgenden Schritte aus, um dem Diagramm die Knoten hinzuzufügen:

1. Wählen Sie im Diagrammmodell " Knoten hinzufügen " aus, um Ihrem Diagramm einen neuen Knoten hinzuzufügen.

2. Geben Sie im Dialogfeld "Knoten zu Diagramm hinzufügen " einen Bezeichnungsnamen ein, und wählen Sie die entsprechende Zuordnungstabelle und Zuordnungsspalte aus.

   

   In diesem Beispiel lautet die Knotenbeschriftung "Kunde", die Zuordnungstabelle ist "Customers", und die Zuordnungsspalte lautet "CustomerID_K".

3. Wählen Sie "Bestätigen ", um den Knoten zu Ihrem Diagramm hinzuzufügen.

4. Wiederholen Sie den Vorgang für alle anderen Knoten. Alle Knoten, die in Ihrem Diagramm dargestellt sind, sollten angezeigt werden.

5. Wählen Sie "Speichern" aus, um mit dem Generieren Ihres Diagramms zu beginnen.

   

Hinzufügen von Kanten

In diesem Abschnitt erstellen wir Kanten, um die Beziehungen zwischen den Knoten im Adventure Works-Datenmodell zu definieren.

Edge	Zuordnungstabelle	Quellknotenzuordnungsspalte	Zielknoten-Zuordnungsspalte
vertreibt	orders	Mitarbeiter MitarbeiterID_FK	Bestellung SalesOrderDetailID_K
Käufe	orders	Customer CustomerID_FK	Bestellung SalesOrderDetailID_K
contains	orders	Bestellung SalesOrderDetailID_K	Produkt ProductID_FK
isOfType	products	Produkt ProductID_K	Produktunterkategorie SubcategoryID_FK
gehörtZu	Produktunterkategorien	Produktunterkategorie SubcategoryID_K	Produktkategorie CategoryID_FK
Produziert	Anbieterprodukt	Hersteller VendorID_FK	Produkt ProductID_FK

Führen Sie die folgenden Schritte aus, um dem Diagramm die Kanten hinzuzufügen:

1. Wählen Sie "Edge hinzufügen" aus, um eine Beziehung zwischen Knoten zu erstellen.

2. Wählen Sie im Dialogfeld "Edge hinzufügen" die Zuordnungstabelle, die Quell- und Zielknoten aus, und definieren Sie die Beziehung.

   

   In diesem Beispiel wird der Rand als "sells" mit der Zuordnungstabelle "orders" definiert, wobei der Quellknoten "Employee" (EmployeeID_FK) mit dem Zielknoten "Order" (SalesOrderDetailID_K) verbunden wird.

3. Wählen Sie "Bestätigen ", um dem Diagramm den Rand hinzuzufügen.

4. Wiederholen Sie den Vorgang für alle anderen Kanten. Alle in Ihrem Diagramm dargestellten Kanten sollten angezeigt werden.

   

An diesem Punkt haben Sie alle Knoten und Kanten für Ihr Diagramm erstellt. Dies ist die grundlegende Struktur Ihres Diagrammmodells.

Laden des Diagramms

Um das Diagramm zu laden, wählen Sie "Speichern" aus. Dadurch wird das Diagrammmodell überprüft, Daten aus OneLake geladen, das Diagramm erstellt und für die Abfrage vorbereitet.

Von Bedeutung

Sie müssen das Diagramm derzeit neu laden (indem Sie "Speichern") auswählen, wenn das Modell oder die zugrunde liegenden Daten geändert werden.

Den Graph abfragen

Graph in Microsoft Fabric verwendet dieselben Arbeitsbereichsrollen wie andere Microsoft Fabric-Elemente. Je nachdem, ob Sie Abfragen über das Graph-Modell oder QuerySet-Element ausführen, gelten die folgenden Arbeitsbereichsrollenberechtigungen.

Berechtigungen für Arbeitsbereichsrollen für das Graphmodell

Fähigkeit	Administrator	Mitglied	Beitragender	Viewer
Erstellen oder Ändern des Diagrammmodells	✔	✔	✔	✖
Diagrammmodell löschen	✔	✔	✔	✖
Anzeigen und Lesen von Inhalten des Diagrammmodells	✔	✔	✔	✔
Diagrammmodell freigeben	✔	✔	✖	✖
Erstellen oder Ändern von Diagrammabfragen	✔	✔	✔	✖
Erstellen oder Ändern des Graph QuerySet-Elements	✔	✔	✔	✖

Berechtigungen für Rollen im Arbeitsbereich für Graph QuerySet

Fähigkeit	Administrator	Mitglied	Beitragender	Viewer
Erstellen oder Ändern des Graph QuerySet-Elements	✔	✔	✔	✖
QuerySet-Element löschen	✔	✔	✔	✖
Anzeigen und Lesen des Inhalts des QuerySet-Elements	✔	✔	✔	✔
Verbinden mit Graph-Instanz	✔	✔	✔	✖
Teilen QuerySet	✔	✔	✖	✖

Hinweis

Alle Benutzer benötigen Lesezugriff auf das zugrunde liegende Diagramminstanzelement, um Abfragen für die Referenzdiagramminstanz aus dem Graph QuerySet-Element auszuführen. Nur Lese-, Schreib- und Freigabeberechtigungen werden für das QuerySet-Element unterstützt.

Verwenden des Abfrage-Generators

Jetzt können wir das Diagramm abfragen, indem wir bestimmte Knoten und Beziehungen auswählen. Alle Abfragen basieren auf der Diagrammstruktur, die wir im vorherigen Abschnitt erstellt haben.

Führen Sie die folgenden Schritte aus, um zum Abfrage-Generator zu wechseln und mit der interaktiven Abfrage Ihres Diagramms zu beginnen:

1. Wählen Sie Modi>Abfrage-Generator auf der Startseite Ihres Diagramms aus. In dieser Ansicht können Sie auch ein schreibgeschütztes Abfrageset erstellen, das die gleichen Funktionen wie unten enthält und Ihnen ermöglicht, Ihre Abfrageergebnisse freizugeben.

2. Wählen Sie "Knoten hinzufügen" aus, um die verfügbaren Knoten für die Abfrage anzuzeigen.

3. Wählen Sie einen Knoten aus, um ihn Ihrer Abfrage hinzuzufügen. In diesem Beispiel fügen wir den Kundenknoten hinzu.

   

4. Von hier aus können Sie Ihre Abfrage erstellen, indem Sie Knoten und Kanten hinzufügen, Filter anwenden und Eigenschaften auswählen, die in den Ergebnissen zurückgegeben werden sollen.

Verwenden des Code-Editors

Wir können das Diagramm auch mithilfe der GQL-Diagrammabfragesprache abfragen.

Führen Sie die folgenden Schritte aus, um zum Code-Editor zu wechseln und mit der Abfrage Ihres Diagramms mit GQL zu beginnen:

1. Wählen Sie Modi>Code-Editor von der Startseite Ihres Diagramms aus.
2. Geben Sie eine GQL-Abfrage in das Eingabefeld ein, z.B. MATCH (n:`Order`) RETURN count(n) AS num_orders.
3. Wählen Sie "Abfrage ausführen" aus, um die Abfrage auszuführen.

Sie können auch komplexere Abfragen ausführen, z. B. Abfragen, die übereinstimmende Diagrammmuster, Filterung, Aggregation, Sortierung und Ober-K-Begrenzung kombinieren:

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

Weitere Informationen zur GQL-Sprachunterstützung finden Sie im GQL-Sprachhandbuch.

Verwandte Inhalte

• GQL-Sprachhandbuch
• GQL-Kurzverweis
• Microsoft Fabric kostenlos testen
• End-to-End-Anleitungen in Microsoft Fabric