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). 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

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

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 nel riquadro Explorer:

    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 Explorer 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.

Non viene visualizzata una visualizzazione per una query 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 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.

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