Utilizzare le visualizzazioni di Spanner Graph

Questa pagina descrive come utilizzare le visualizzazioni dei grafici Spanner. Una visualizzazione Spanner Graph può mostrare gli elementi del grafico restituiti da una query o gli elementi di uno schema del grafico. Le visualizzazioni ti aiutano a capire come sono collegati i punti dati (nodi). Mentre una tabella con centinaia di punti di dati può essere difficile da interpretare, la sua visualizzazione del grafico può rivelare pattern, dipendenze e anomalie.

Visualizza i risultati delle query Spanner Graph

Per visualizzare i risultati della query Spanner Graph in Spanner Studio, la query deve restituire gli elementi del grafico in formato JSON utilizzando la funzione SAFE_TO_JSON o TO_JSON. Ti consigliamo di restituire i percorsi del grafico anziché restituire i nodi e gli archi singolarmente. I percorsi di ritorno offrono i seguenti vantaggi:

  • I percorsi contengono dati completi di nodi e archi. Alcuni nodi e archi intermedi in una visualizzazione di una query complessa potrebbero non essere disponibili se restituisci singoli nodi e archi.

  • Se restituisci i percorsi, l'istruzione RETURN può essere meno complessa rispetto a se restituisci nodi e archi singolarmente.

La seguente query di esempio restituisce i percorsi dei trasferimenti di account, che puoi visualizzare:

GRAPH FinGraph
MATCH result_paths = (account:Account {is_blocked: True})-[:Transfers]->(dest_account:Account)
RETURN SAFE_TO_JSON(result_paths) AS result_paths

Dopo aver eseguito una query, l'area dei risultati della query mostra la visualizzazione. Il riquadro dei dettagli mostra un riepilogo delle etichette di nodi e archi con i conteggi per ciascuna. Fai clic su un nodo o un arco per navigare nel grafico e visualizzare proprietà, nodi adiacenti e connessioni, come mostrato nello screenshot seguente. In alternativa, puoi visualizzare i risultati della query come tabella o passare a una visualizzazione dello schema del grafico sottostante.

Pulsante di attivazione/disattivazione del risultato della query.

Per ulteriori informazioni, vedi Restituisci elementi del grafico come JSON.

Scegli un layout di visualizzazione di Spanner Graph

Il menu nel riquadro di visualizzazione offre le seguenti opzioni di layout:

  • Forza layout (impostazione predefinita): presenta i nodi come punti che si respingono a vicenda, mentre i nodi connessi si avvicinano, simulando forze fisiche per creare un layout visivamente intuitivo.

  • Gerarchico: posiziona i nodi per creare una gerarchia visiva in base alla connettività.

  • Sequenziale: posiziona i nodi per creare una sequenza visiva in base alla connettività.

  • Mostra etichette: mostra tutte le etichette di nodi e archi nel grafico a tutti i livelli di zoom.

Risolvere i problemi relativi alle visualizzazioni del grafico Spanner

Di seguito sono riportati alcuni suggerimenti che possono aiutarti a risolvere i problemi e a comprendere il comportamento della visualizzazione di Spanner Graph.

Per una query Spanner Graph non viene visualizzata una visualizzazione

Problema: esegui una query Spanner Graph e viene visualizzata solo in formato tabella.

Possibile causa: la query non restituisce elementi del grafico in formato JSON. Ad esempio:

  • La seguente query non può essere visualizzata perché restituisce identificatori di nodi e bordi:
GRAPH FinGraph
MATCH (person:Person {name: "Dana"})-[owns:Owns]->(account:Account)
RETURN person.id as person_id, account.id as account_id
  • La seguente query non può essere visualizzata perché restituisce valori di proprietà:
GRAPH FinGraph
MATCH (person:Person {name: "Dana"})-[owns:Owns]->(account:Account)
RETURN owns.create_time, account.nick_name

Soluzione consigliata:

Restituisci gli elementi del grafico in formato JSON utilizzando SAFE_TO_JSON o TO_JSON. Per maggiori informazioni, consulta Visualizzare i risultati della query Spanner Graph.

I risultati della query Spanner Graph vengono visualizzati parzialmente

Problema: una visualizzazione dei risultati di una query mostra solo una parte dei risultati della query.

Possibile causa: la query restituisce più di 10 MB di dati. Una visualizzazione della query può mostrare fino a 10 MB di dati.

Soluzione consigliata: semplifica la query in modo che restituisca meno di 10 MB di dati.

Una visualizzazione del grafico Spanner include un nodo o un arco con un'etichetta imprevista

Problema: un nodo o un arco in una visualizzazione del grafico Spanner mostra un'etichetta inattesa.

Possibile causa: il nodo o il bordo ha più etichette. Una visualizzazione del grafico Spanner può mostrare un'etichetta per ogni nodo e arco. Se un nodo o un arco ha più di un'etichetta, nella visualizzazione viene mostrata la prima.

Soluzione consigliata: nessuna. Non puoi modificare l'etichetta visualizzata.

Alcuni elementi del grafico non vengono visualizzati in una visualizzazione del grafico Spanner

Problema: una visualizzazione include tutti i nodi e gli archi restituiti, ma alcuni elementi del grafico non vengono visualizzati.

Possibile causa: la query utilizzata per creare la visualizzazione del grafico Spanner restituisce singoli nodi e archi anziché un percorso del grafico.

Soluzione consigliata: aggiorna la query in modo che restituisca un percorso del grafico.

Passaggi successivi