Udostępnij przez

graph, funkcja (wersja zapoznawcza)

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Uwaga / Notatka

Ta funkcja jest obecnie w publicznej wersji zapoznawczej. Funkcje i składnia mogą ulec zmianie przed ogólną dostępnością.

Funkcja graph jest funkcją wewnętrzną, która umożliwia wykonywanie zapytań dotyczących utrwalonej jednostki grafu, podobnie jak cluster()w przypadku funkcji , database(), external_table()i table() . Obsługuje pobieranie najnowszej migawki grafu, konkretnej migawki lub tworzenie przejściowego grafu na podstawie modelu.

Uprawnienia

Aby uruchomić tę funkcję, użytkownik musi mieć uprawnienia przeglądarki bazy danych.

Składnia

graph( Nazwa grafu)

graph( , SnapshotName)

graph( , snapshot= SnapshotName)

graph( , Przemijający)

Parametry

Nazwa Typ Wymagane Opis
Nazwa grafu string ✔️ Nazwa modelu grafu do wykonywania zapytań.
SnapshotName string Nazwa określonej migawki do pobrania. Jeśli nie zostanie określona, zostanie użyta najnowsza migawka.
Przemijający bool Jeśli trueelement tworzy wykres przejściowy na podstawie modelu (nie jest używana migawka). Jeśli falseprogram używa najnowszej migawki (takiej samej jak pominięcie tego parametru).

Zwraca

Funkcja graph zwraca wykres i musi być obserwowana przez operator grafu. Funkcja pobiera określoną nazwę modelu grafu w następujący sposób:

  • Najnowsza migawka (domyślna lub false określona)
  • Określona nazwana migawka
  • Wykres przejściowy z modelu (po true określeniu)

Przykłady

Wykonywanie zapytań dotyczących najnowszej migawki

Poniższy przykład wykonuje zapytanie dotyczące najnowszej migawki utrwalonego grafu o nazwie "SecurityGraph":

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

Wykonywanie zapytań względem określonej migawki

Poniższy przykład wykonuje zapytanie o określoną migawkę grafu:

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

Zapytanie o nazwaną składnię parametrów

W poniższym przykładzie użyto nazwanej składni parametru do określenia migawki:

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

Tworzenie wykresu przejściowego na podstawie modelu

Poniższy przykład tworzy wykres przejściowy na podstawie modelu, podobny do make-graph operatora:

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

Użyj wartości false, aby określić najnowszą migawkę

Poniższy przykład jawnie określa false użycie najnowszej migawki, która jest odpowiednikiem pominięcia drugiego parametru:

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

Treści powiązane

  • Last updated on