Utilizzare le visualizzazioni di Spanner Graph

Le visualizzazioni di Spanner Graph mostrano gli elementi del grafico restituiti da una query o gli elementi di uno schema del grafico. Una visualizzazione ti aiuta a capire come sono collegati i punti dati (nodi) (archi). Mentre una tabella con centinaia di punti di dati può essere difficile da interpretare, la sua visualizzazione grafica può rivelare pattern, dipendenze e anomalie.

Visualizzare i risultati delle query Spanner Graph

Puoi utilizzare la console Google Cloud per visualizzare i risultati delle query Spanner Graph in Spanner Studio. Per visualizzare una query con Spanner Graph, la query deve restituire 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 nodi e 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 quando 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 saperne di più, consulta Restituisci elementi del grafico come JSON.

Scegliere le opzioni di visualizzazione dei risultati della query

Puoi aggiornare l'aspetto dei nodi in una visualizzazione di query. Ad esempio, puoi specificare il layout della visualizzazione della query, il colore dei nodi e la proprietà visualizzata su ogni nodo.

Gli aggiornamenti della visualizzazione dei risultati delle query riguardano la sessione di visualizzazione dei risultati della query attuale. Gli aggiornamenti alle opzioni di visualizzazione non vengono mantenuti se esegui di nuovo la stessa query.

Scegli un layout di visualizzazione di Spanner Graph

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

  • Forza layout (impostazione predefinita): mostra 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.

Scegli la proprietà del nodo da visualizzare

Per impostazione predefinita, un nodo mostra la sua prima proprietà. Se vuoi che un nodo mostri una proprietà diversa, procedi nel seguente modo:

  1. Quando visualizzi una visualizzazione dei risultati di una query Spanner Graph, fai clic su Passa alla visualizzazione dello schema nella scheda Risultati del riquadro dei risultati della query.

  2. Nella visualizzazione dello schema, fai clic su un nodo del tipo che vuoi aggiornare.

  3. Nel riquadro dei dettagli visualizzato per il nodo selezionato, fai clic sulla proprietà che vuoi visualizzare. Tutti i nodi nei risultati della query del tipo di nodo selezionato mostrano la proprietà selezionata.

Scegliere il colore dei nodi

  1. Quando visualizzi una visualizzazione dei risultati di una query Spanner Graph, fai clic su Passa alla visualizzazione dello schema nella scheda Risultati del riquadro dei risultati della query.

  2. Nella visualizzazione dello schema, fai clic su un nodo del tipo che vuoi aggiornare.

  3. Nel riquadro dei dettagli visualizzato per il nodo selezionato, fai clic su Opzioni di visualizzazione dei nodi.

  4. Fai clic su un colore o inserisci un codice colore esadecimale personalizzato. Tutti i nodi nei risultati della query che sono del tipo di nodo selezionato vengono visualizzati con il colore che scegli.

Visualizzare uno schema di Spanner Graph

La struttura di un grafico Spanner, come nodi, archi, etichette e proprietà, è definita dallo schema, che mappa gli elementi del grafico ai dati nelle tabelle Spanner. La definizione del grafico viene memorizzata in uno schema che crei utilizzando le tabelle di input oppure è evidente dai dati quando utilizzi la gestione dei dati senza schema.

Puoi visualizzare i grafici che crei con uno schema o quelli che utilizzano la gestione dei dati senza schema. La visualizzazione dello schema ti aiuta a comprendere la struttura del grafico, inclusi i tipi di nodi e archi che contiene e il modo in cui sono collegati. Può essere utile per grafici complessi, in quanto fornisce una visione chiara delle relazioni che potrebbero essere difficili da dedurre dalle sole istruzioni DDL.

Puoi visualizzare una visualizzazione di uno schema di Spanner Graph nella consoleGoogle Cloud in uno dei seguenti modi:

  • Quando visualizzi una visualizzazione dei risultati di una query Spanner Graph, fai clic su Passa alla visualizzazione dello schema nella scheda Risultati del riquadro dei risultati della query.

    Pulsante per passare alla visualizzazione schema.

  • Fai clic su Visualizza schema in un grafico Spanner in Esplora oggetti:

    1. Nella console Google Cloud , apri la pagina Spanner.

      Vai a Spanner

    2. Seleziona un'istanza dall'elenco.

    3. Seleziona un database.

    4. Nel menu di navigazione, fai clic su Spanner Studio. Il riquadro Esplora oggetti mostra un elenco degli oggetti nel database.

    5. Fai clic su Visualizza azioni in un grafico Spanner, quindi fai clic su Visualizza schema.

Risolvere i problemi relativi alle visualizzazioni di Spanner Graph

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 alcuna 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 archi:
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 delle query Spanner Graph.

I risultati della query Spanner Graph sono 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.

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