Delen via

grafiekfunctie (preview)

Schakelen tussen services met behulp van de vervolgkeuzelijst Versie . Meer informatie over navigatie.
Van toepassing op: ✅ Microsoft Fabric ✅ Azure Data Explorer

Opmerking

Deze functie is momenteel beschikbaar als openbare preview-versie. Functionaliteit en syntaxis kunnen worden gewijzigd vóór algemene beschikbaarheid.

De graph functie is een intrinsieke functie waarmee query's kunnen worden uitgevoerd op een persistente grafiekentiteit, vergelijkbaar met de cluster(), database()en external_table()functies table() . Het biedt ondersteuning voor het ophalen van de meest recente momentopname van de grafiek, een specifieke momentopname of het maken van een tijdelijke grafiek op basis van het model.

Machtigingen

Om deze functie uit te voeren, heeft de gebruiker machtigingen voor databaseviewer nodig.

Syntaxis

graph( GraphName)

graph( GraphName,SnapshotName)

graph( GraphName,snapshot=SnapshotName)

graph( GraphName,Kortstondig)

Parameterwaarden

Naam Typologie Verplicht Beschrijving
GraphName string ✔️ De naam van het grafiekmodel dat u wilt opvragen.
SnapshotName string De naam van een specifieke momentopname die moet worden opgehaald. Als dit niet is opgegeven, wordt de meest recente momentopname gebruikt.
Kortstondig bool Als true, maakt u een tijdelijke grafiek van het model (er wordt geen momentopname gebruikt). Als falseu de meest recente momentopname gebruikt (hetzelfde als het weglaten van deze parameter).

Retouren

De graph functie retourneert een grafiek en moet worden gevolgd door een grafiekoperator. De functie haalt de naam van het opgegeven grafiekmodel op, ofwel als:

  • De meest recente momentopname (standaard of wanneer false is opgegeven)
  • Een specifieke benoemde momentopname
  • Een tijdelijke grafiek van het model (wanneer true is opgegeven)

Voorbeelden

Query uitvoeren op de meest recente momentopname

In het volgende voorbeeld wordt een query uitgevoerd op de meest recente momentopname van een persistente grafiek met de naam 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

Een query uitvoeren op een specifieke momentopname

In het volgende voorbeeld wordt een specifieke momentopname van de grafiek opgevraagd:

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

Query met benoemde parametersyntaxis

In het volgende voorbeeld wordt de syntaxis van de benoemde parameter gebruikt om een momentopname op te geven:

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

Een tijdelijke grafiek maken op basis van het model

In het volgende voorbeeld wordt een tijdelijke grafiek gemaakt op basis van het model, vergelijkbaar met de 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

Onwaar gebruiken om de meest recente momentopname op te geven

In het volgende voorbeeld wordt expliciet aangegeven false dat de meest recente momentopname moet worden gebruikt, wat gelijk is aan het weglaten van de tweede parameter:

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

Verwante inhoud

  • Last updated on