Condividi tramite

funzione graph (anteprima)

Si applica a: ✅Microsoft Fabric✅Esplora dati di Azure

Annotazioni

Questa funzionalità è attualmente disponibile in anteprima pubblica. La funzionalità e la sintassi sono soggette a modifiche prima della disponibilità generale.

La graph funzione è una funzione intrinseca che consente l'esecuzione di query su un'entità del grafo persistente, simile alle cluster()funzioni , database()external_table(), e table() . Supporta il recupero dello snapshot più recente del grafico, uno snapshot specifico o la creazione di un grafo temporaneo dal modello.

Autorizzazioni

Per eseguire questa funzione, l'utente deve disporre delle autorizzazioni del visualizzatore di database.

Sintassi

graph( GraphName)

graph( GraphName,SnapshotName)

graph( GraphName,snapshot=SnapshotName)

graph( GraphName,Transitorio)

Parametri

Nome TIPO Obbligatorio Descrizione
GraphName string ✔️ Nome del modello a grafo su cui eseguire una query.
SnapshotName string Nome di uno snapshot specifico da recuperare. Se non specificato, viene usato lo snapshot più recente.
Temporaneo bool Se true, crea un grafico temporaneo dal modello (non viene usato alcuno snapshot). Se false, usa lo snapshot più recente (come omettere questo parametro).

Restituzioni

La graph funzione restituisce un grafico e deve essere seguita da un operatore del grafo. La funzione recupera il nome del modello a grafo specificato, come segue:

  • Snapshot più recente (impostazione predefinita o quando false viene specificato)
  • Uno snapshot denominato specifico
  • Grafico temporaneo dal modello (quando true viene specificato)

Esempi

Eseguire una query sullo snapshot più recente

L'esempio seguente esegue una query sullo snapshot più recente di un grafico persistente denominato "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

Eseguire query su uno snapshot specifico

L'esempio seguente esegue una query su uno snapshot specifico del grafico:

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

Eseguire una query con la sintassi dei parametri denominati

Nell'esempio seguente viene utilizzata la sintassi dei parametri denominati per specificare uno snapshot:

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

Creare un grafo temporaneo dal modello

L'esempio seguente crea un grafico temporaneo dal modello, simile all'operatore make-graph :

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

Usare false per specificare lo snapshot più recente

Nell'esempio seguente viene false specificato in modo esplicito l'uso dello snapshot più recente, che equivale a omettere il secondo parametro:

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

Contenuti correlati

  • Last updated on