Utilizzare le visualizzazioni di Spanner Graph

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

Visualizzare i risultati delle query di Spanner Graph

Per visualizzare i risultati delle query di Spanner Graph in Spanner Studio, la query deve restituire gli elementi del grafo in formato JSON utilizzando la funzione SAFE_TO_JSON o TO_JSON. Inoltre, ti consigliamo di restituire i percorsi del grafo anziché i nodi e gli archi singolarmente. I vantaggi dei percorsi di ritorno includono:

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

  • Se restituisci percorsi, l'istruzione RETURN può essere meno complessa rispetto al caso in cui restituisci nodi ed archi singolarmente.

La seguente query di esempio restituisce i percorsi dei trasferimenti di account che possono essere visualizzati:

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, la visualizzazione viene visualizzata nell'area dei risultati della query. Il riquadro dei dettagli mostra un riepilogo delle etichette dei nodi e degli archi con i conteggi per ciascuno. Fai clic su un nodo o un bordo per spostarti nel grafico e visualizzare proprietà, elementi vicini e connessioni, come mostrato nello screenshot seguente. In alternativa, puoi anche 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, consulta Restituire gli elementi del grafico come JSON.

Scegli un layout di visualizzazione del grafico di Spanner

Nel menu del riquadro di visualizzazione sono disponibili le seguenti opzioni di layout:

  • Forza layout (impostazione predefinita): mostra i nodi come punti che si respingono a vicenda, mentre i nodi collegati vengono uniti, simulando forze fisiche come il magnetismo, per creare un layout visivamente intuitivo
  • Gerarchica: posiziona i nodi per generare una gerarchia visiva in base alla connettività
  • Sequenziale: posiziona i nodi per generare una sequenza visiva in base alla connettività
  • Mostra etichette: mostra tutte le etichette dei nodi e degli archi nel grafico, indipendentemente dal livello di zoom.

Risolvere i problemi relativi alle visualizzazioni

Di seguito sono riportate alcune informazioni che possono aiutarti a risolvere i problemi e comprendere il comportamento e la visualizzazione di Spanner Graph.

Una visualizzazione non viene visualizzata per una query di Spanner Graph

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 gli 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:

Restituire gli elementi del grafico in formato JSON utilizzando SAFE_TO_JSON o TO_JSON. Per ulteriori informazioni, consulta Visualizzare i risultati delle query di Spanner Graph.

I risultati della query vengono visualizzati parzialmente

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

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

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

Un nodo o un bordo viene visualizzato con un'etichetta imprevista

Problema: un nodo o un bordo in una visualizzazione del grafico mostra un'etichetta imprevista.

Possibile causa: il nodo o l'arco ha più etichette. Una visualizzazione del grafico Spanner può mostrare un'etichetta per ogni nodo e bordo. Se un nodo o un'associazione 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 sono disponibili in una visualizzazione

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

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

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

Passaggi successivi