Visualizzare i grafici

Per richiedere assistenza o fornire feedback su questa funzionalità, invia un'email all'indirizzo bq-graph-preview-support@google.com.

Le visualizzazioni di BigQuery Graph mostrano i risultati restituiti da una query di uno schema di grafico. Puoi visualizzare i grafici in BigQuery Studio o in un ambiente notebook, come Google Colab o Jupyter Notebook.

Una visualizzazione ti aiuta a capire come sono collegati i punti dati (nodi) (archi). Sebbene una tabella di centinaia di punti dati possa essere difficile da interpretare, la sua visualizzazione del grafico può rivelare pattern, dipendenze e anomalie.

Visualizzare i risultati delle query di BigQuery Graph

Puoi utilizzare la Google Cloud console per visualizzare i risultati delle query di BigQuery Graph in BigQuery Studio. Per visualizzare una query con BigQuery Graph, la query deve restituire elementi del grafico in formato JSON utilizzando la TO_JSON funzione. Ti consigliamo di restituire i percorsi del grafico anziché i nodi e gli archi singolarmente. La restituzione dei percorsi offre i seguenti vantaggi:

I percorsi contengono i 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 i nodi e gli archi singolarmente.

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

GRAPH graph_db.FinGraph
MATCH
  p = (person:Person {name: "Dana"})-[own:Owns]->
  (account:Account)-[transfer:Transfers]->(account2:Account)<-[own2:Owns]-(person2:Person)
RETURN
  TO_JSON(p) AS path;

Per visualizzare i risultati, nel riquadro Risultati query fai clic su Grafico. Il riquadro dei dettagli mostra un riepilogo delle etichette dei nodi e degli archi con i conteggi per ciascuna. Fai clic su un nodo o un arco per navigare nel grafico e visualizzare proprietà, vicini e connessioni. In alternativa, puoi visualizzare i risultati della query come tabella o passare a una visualizzazione dello schema del grafico sottostante.

Visualizzazione dei risultati della query.

Per saperne di più, consulta Restituire elementi del grafico in formato JSON.

Scegliere le opzioni di visualizzazione dei risultati delle query

Puoi aggiornare l'aspetto dei nodi in una visualizzazione delle query. Ad esempio, puoi specificare il layout della visualizzazione delle 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 delle query corrente. Gli aggiornamenti delle opzioni di visualizzazione non vengono mantenuti se esegui di nuovo la stessa query.

Scegliere un layout per una visualizzazione di BigQuery Graph

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

Layout forzato (impostazione predefinita): presenta i nodi come punti che si respingono a vicenda, mentre i nodi connessi si avvicinano, simulando le 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 dei nodi e degli archi sul grafico a tutti i livelli di zoom.

Scegliere la proprietà del nodo o dell'arco da visualizzare

Per impostazione predefinita, un nodo o un arco visualizza la sua prima proprietà. Se vuoi che un nodo o un arco visualizzi una proprietà diversa:

Quando visualizzi una visualizzazione dei risultati di una query di BigQuery Graph, fai clic su **Passa alla visualizzazione dello schema** nella scheda **Risultati** del riquadro dei risultati della query.
Nella visualizzazione dello schema, fai clic su un nodo o un arco del tipo che vuoi aggiornare.
Nel riquadro dei dettagli visualizzato per il nodo o l'arco selezionato, fai clic sulla proprietà che vuoi visualizzare. Tutti i nodi o gli archi nei risultati della query che sono del tipo di nodo o arco selezionato mostrano la proprietà selezionata.

Scegliere il colore dei nodi

Quando visualizzi una visualizzazione dei risultati di una query di BigQuery Graph, fai clic su Passa alla visualizzazione dello schema nella scheda Risultati del riquadro dei risultati della query.
Nella visualizzazione dello schema, fai clic su un nodo del tipo che vuoi aggiornare.
Nel riquadro dei dettagli visualizzato per il nodo selezionato, fai clic su Opzioni di visualizzazione dei nodi.
Fai clic su un colore. Tutti i nodi nei risultati della query che sono del tipo di nodo selezionato vengono visualizzati con il colore scelto.

Scegliere i nodi da visualizzare

Per scegliere i nodi da visualizzare in una visualizzazione:

Nella visualizzazione della query, fai clic con il tasto destro del mouse su un nodo.
Fai clic su una delle seguenti opzioni di menu per modificare lo stato del grafico visibile:
- Espandi esegue il rendering dei nodi adiacenti attraversando tutti gli archi in entrata, gli archi in uscita o filtrando in base a un tipo di arco specifico.
- Comprimi elimina la visualizzazione corrente nascondendo tutti i nodi collegati al nodo di destinazione utilizzando gli archi in entrata, gli archi in uscita o un tipo di arco specifico.
- Nascondi nodo rimuove il nodo di destinazione dalla visualizzazione corrente.
- Mostra solo i vicini nasconde tutti i nodi nel grafico, ad eccezione del nodo di destinazione e di quelli direttamente collegati.
- Evidenzia nodo evidenzia il nodo di destinazione.

Visualizzare uno schema di BigQuery Graph

La struttura di un grafico, inclusi nodi, archi, etichette e proprietà, è definita dal suo schema, che mappa gli elementi del grafico ai dati nelle tabelle BigQuery. La definizione del grafico viene memorizzata in uno schema che crei utilizzando le tabelle di input.

Puoi visualizzare i grafici che crei con uno 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. Questa funzionalità può essere utile per i grafici complessi, in quanto fornisce una visione chiara delle relazioni che potrebbero essere difficili da dedurre solo dalle istruzioni DDL.

Per visualizzare uno schema di grafico:

In BigQuery Studio, vai al riquadro Spazio di esplorazione.
Espandi il set di dati contenente il grafico, espandi Grafici e quindi seleziona il grafico.
Fai clic sulla scheda Grafico.

Visualizzare i risultati delle query e gli schemi in un ambiente notebook

Puoi visualizzare i risultati delle query sui grafici e gli schemi dei grafici in ambienti notebook come BigQuery Studio, Google Colab e Jupyter Notebook. La visualizzazione viene implementata come IPython Magics.

Visualizzare i risultati delle query sui grafici

Per visualizzare i risultati delle query in un notebook:

In una cella del notebook, esegui il seguente comando per installare la libreria BigQuery Magics più recente:
```
!pip install bigquery_magics==0.12.1
```
Nell'ambiente notebook, assicurati di aver installato la libreria client di BigQuery Graph.
In una cella del notebook, utilizza il comando magico %%bigquery --graph seguito dalla query GQL. La query deve restituire elementi del grafico in formato JSON utilizzando la TO_JSON funzione. Ti consigliamo di restituire i percorsi del grafico anziché i singoli nodi e archi. La restituzione dei percorsi offre i seguenti vantaggi:
- I percorsi contengono i dati completi di nodi e archi. Se restituisci singoli nodi e archi, alcuni nodi e archi intermedi nella visualizzazione di una query complessa potrebbero non essere disponibili.
- Se restituisci i percorsi, l'istruzione RETURN è meno complessa rispetto a quando restituisci i singoli nodi e archi.
Esegui la cella. La visualizzazione viene mostrata nell'area di output della cella.

La seguente query di esempio trova una persona, i suoi account e i trasferimenti tra gli account, quindi restituisce i risultati in un notebook:

%%bigquery --graph
GRAPH graph_db.FinGraph
MATCH
  p = ((person:Person {name: "Dana"})-[own:Owns]->
  (account:Account)-[transfer:Transfers]->(account2:Account)<-[own2:Owns]-(person2:Person))
RETURN
  TO_JSON(p) AS path;

Dopo aver eseguito una query, l'area di output mostra la visualizzazione. Il riquadro dei dettagli mostra un riepilogo delle etichette dei nodi e degli archi con i conteggi per ciascuna. Fai clic su un nodo o un arco per navigare nel grafico e visualizzare proprietà, vicini e connessioni. L'immagine seguente mostra proprietà, vicini e connessioni.

Visualizzazione dei risultati della query.

Visualizzare uno schema di BigQuery Graph

La struttura di un grafico, inclusi nodi, archi, etichette e proprietà, è definita dal suo schema, che mappa i dati nelle tabelle BigQuery agli elementi del grafico. La definizione del grafico viene memorizzata in uno schema che crei utilizzando le tabelle di input.

Puoi visualizzare i grafici che crei con uno schema. La visualizzazione dello schema ti aiuta a comprendere la struttura del grafico, inclusi i tipi di nodi e archi che contiene e le relative connessioni. Questa funzionalità può essere utile per i grafici complessi, in quanto fornisce una visione chiara delle relazioni che potrebbero essere difficili da dedurre dalle istruzioni DDL utilizzate per creare il grafico. L'immagine seguente mostra un esempio di visualizzazione dello schema di un grafico.

Visualizzazione di uno schema del grafico.

Per visualizzare uno schema di BigQuery Graph in un notebook:

In una cella del notebook, esegui il seguente comando per installare la libreria BigQuery Magics:
```
!pip install bigquery_magics==0.12.1
```
Nell'ambiente notebook, assicurati di aver installato la libreria client di BigQuery Graph.
In una cella del notebook, utilizza il comando magico %%bigquery --graph seguito dalla query GQL. La query deve restituire elementi del grafico in formato JSON utilizzando la TO_JSON funzione.
Esegui la cella. La visualizzazione viene mostrata nell'area di output della cella.
Nell'output della visualizzazione, fai clic su schema Visualizzazione dello schema.

Risolvere i problemi relativi alle visualizzazioni di BigQuery Graph

Le seguenti informazioni possono aiutarti a risolvere i problemi e a comprendere il comportamento delle visualizzazioni di BigQuery Graph.

Non viene visualizzata una visualizzazione per una query di BigQuery Graph

Problema: esegui una query di BigQuery Graph, ma 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 valori delle proprietà anziché elementi del grafico in formato JSON:

GRAPH graph_db.FinGraph
MATCH (person:Person {name: "Dana"})-[owns:Owns]->(account:Account)
RETURN owns.create_time, account.nick_name;

Soluzione:

Restituisci gli elementi del grafico in formato JSON utilizzando TO_JSON. Per saperne di più, consulta Visualizzare i risultati delle query di BigQuery Graph.

I risultati delle query di BigQuery Graph vengono visualizzati parzialmente

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

Possibile causa: se utilizzi una visualizzazione del notebook, la query restituisce più di 2 MB di dati. Una visualizzazione del notebook ha un limite di 2 MB, mentre la Google Cloud visualizzazione della console non ha un limite rigido.

Soluzione: se utilizzi un notebook, semplifica la query in modo che restituisca meno di 2 MB di dati oppure utilizza la Google Cloud console per visualizzare i risultati.

Alcuni elementi del grafico non vengono visualizzati in una visualizzazione di BigQuery Graph

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 di BigQuery Graph restituisce singoli nodi e archi anziché un percorso del grafico.

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

Passaggi successivi

Scopri di più su BigQuery Graph.
Scopri come creare ed eseguire query su un grafico.
Scopri gli strumenti e le integrazioni di visualizzazione dei grafici.