Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: ✅Microsoft Fabric✅Azure Data Explorer
Hinweis
Dieses Feature ist zurzeit als öffentliche Preview verfügbar. Funktionalität und Syntax können vor der allgemeinen Verfügbarkeit geändert werden.
Die graph Funktion ist eine systeminterne Funktion, die das Abfragen einer dauerhaften Diagrammentität ermöglicht, ähnlich wie die cluster(), database(), und external_table()table() Funktionen. Es unterstützt das Abrufen der neuesten Momentaufnahme des Diagramms, einer bestimmten Momentaufnahme oder das Erstellen eines vorübergehenden Diagramms aus dem Modell.
Erlaubnisse
Um diese Funktion auszuführen, benötigt der Benutzer Datenbankanzeigeberechtigungen.
Syntax
graph(
GraphName)
graph(
GraphName,SnapshotName)
graph(
GraphName,snapshot=SnapshotName)
graph(
GraphName,Flüchtig)
Die Parameter
| Name | Typ | Erforderlich | BESCHREIBUNG |
|---|---|---|---|
| GraphName | string |
✔️ | Der Name des abzufragenden Diagrammmodells . |
| SnapshotName | string |
Der Name einer bestimmten Momentaufnahme, die abgerufen werden soll. Wenn nicht angegeben, wird die aktuellste Momentaufnahme verwendet. | |
| Vorübergehend | bool |
Wenn true, erstellt ein vorübergehendes Diagramm aus dem Modell (es wird keine Momentaufnahme verwendet). Wenn false, verwendet die neueste Momentaufnahme (identisch mit dem Weglassen dieses Parameters). |
Rückkehr
Die graph Funktion gibt ein Diagramm zurück und muss einem Diagrammoperator folgen. Die Funktion ruft den angegebenen Diagrammmodellnamen ab, entweder wie:
- Die neueste Momentaufnahme (Standard oder wann
falseangegeben) - Eine bestimmte benannte Momentaufnahme
- Ein vorübergehendes Diagramm aus dem Modell (sofern
trueangegeben)
Beispiele
Abfragen der neuesten Momentaufnahme
Im folgenden Beispiel wird die aktuellste Momentaufnahme eines dauerhaften Diagramms mit dem Namen "SecurityGraph" abgefragt:
graph("SecurityGraph")
| graph-match (user)-[permission]->(resource)
where user.type == "User" and resource.type == "Database"
project UserName = user.name, ResourceName = resource.name, Permission = permission.type
Abfragen einer bestimmten Momentaufnahme
Im folgenden Beispiel wird eine bestimmte Momentaufnahme des Diagramms abfragen:
graph("SecurityGraph", "Snapshot_2025_05_01")
| graph-match (attacker)-[attacks]->(target)-[connects]->(system)
where attacker.name == "MaliciousActor"
project Attacker = attacker.name, Target = target.name, System = system.name
Abfrage mit benannter Parametersyntax
Im folgenden Beispiel wird die Benannte Parametersyntax verwendet, um eine Momentaufnahme anzugeben:
graph("SecurityGraph", snapshot="Snapshot_2025_05_01")
| graph-shortest-paths (start)-[e*1..20]->(end)
where start.name == "Alice" and end.name == "Database"
project PathLength = array_length(e), Path = e
Erstellen eines vorübergehenden Diagramms aus dem Modell
Im folgenden Beispiel wird ein vorübergehendes Diagramm aus dem Modell erstellt, ähnlich dem make-graph Operator:
graph("SecurityGraph", true)
| graph-match (user)-[permission]->(resource)
where user.type == "User" and resource.type == "Database"
project UserName = user.name, ResourceName = resource.name, Permission = permission.type
Verwenden von "false" zum Angeben der neuesten Momentaufnahme
Im folgenden Beispiel wird explizit angegeben false , dass die neueste Momentaufnahme verwendet wird. Dies entspricht dem Weglassen des zweiten Parameters:
graph("SecurityGraph", false)
| graph-match (user)-[permission]->(resource)
where user.type == "User" and resource.type == "Database"
project UserName = user.name, ResourceName = resource.name, Permission = permission.type