Panoramica degli snapshot del grafo (anteprima)

2025-05-28

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.

Uno snapshot del grafo è un'entità di database che rappresenta un'istanza materializzata di un modello a grafo in un momento specifico. Mentre un modello a grafo definisce la struttura e le origini dati, uno snapshot è l'implementazione del grafo su cui è possibile eseguire query.

Informazioni generali

Gli snapshot del grafo forniscono:

Collegamento del modello: connesso a un modello a grafo specifico
Materializzazione temporizzato: rappresenta lo stato del grafo in fase di creazione
Persistenza: archiviata nel database fino a quando non viene eliminata in modo esplicito
Esecuzione di query dirette: abilita le query senza ricompilare il grafico
Archiviazione dei metadati: contiene informazioni sul tempo di creazione e sul modello

Più snapshot dello stesso modello a grafo consentono l'analisi cronologica e il confronto temporale dei dati del grafo.

Struttura dello snapshot del grafo

Ogni snapshot del grafo contiene due componenti principali:

Metadati

Nome: identificatore di snapshot univoco
SnapshotTime: timestamp di creazione
Informazioni sul modello:
- ModelName: nome del modello del grafo di origine
- ModelVersion: versione del modello in fase di creazione dello snapshot
- ModelCreationTime: timestamp di creazione del modello di origine

Dati a grafo

Nodi: nodi materializzati dalle operazioni del AddNodes modello
Archi: relazioni materializzate dalle operazioni del AddEdges modello
Proprietà: proprietà del nodo e dei bordi, come definito nel modello

Esempio di configurazione dello snapshot

{
  "Metadata": {
    "Name": "UserInteractionsSnapshot",
    "SnapshotTime": "2025-04-28T10:15:30Z"
  },
  "ModelInformation": {
    "ModelName": "SocialNetworkGraph",
    "ModelVersion": "v1.2",
    "ModelCreationTime": "2025-04-15T08:20:10Z"
  }
}

Comandi di gestione

Usare questi comandi per gestire gli snapshot del grafo:

Comando	Scopo
.make graph_snapshot	Creare uno snapshot da un modello a grafo esistente
.drop graph_snapshot	Rimuovere uno snapshot dal database
.show graph_snapshots	Elencare gli snapshot disponibili nel database

Esecuzione di query sugli snapshot

Eseguire query sugli snapshot del grafo usando la graph() funzione :

Eseguire una query sullo snapshot più recente

graph("SocialNetworkGraph") 
| graph-match (person)-[knows]->(friend)
  where person.age > 30
  project person.name, friend.name

Eseguire query su uno snapshot specifico

graph("SocialNetworkGraph", "UserInteractionsSnapshot") 
| graph-match (person)-[knows]->(friend)
  where person.age > 30
  project person.name, friend.name

Per i criteri di ricerca avanzati e gli attraversamenti, vedere Operatori graph.

Vantaggi principali