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 gli elementi del grafico restituiti da una query o gli elementi di uno schema del grafico. Puoi visualizzare i grafici in un ambiente notebook, come BigQuery Studio, 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 relativa visualizzazione del grafico può rivelare pattern, dipendenze e anomalie.

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:

  1. In una cella del notebook, esegui il seguente comando per installare la libreria BigQuery Magics più recente:

    !pip install bigquery_magics==0.12.1

  2. Nell'ambiente notebook, assicurati di aver installato la libreria client BigQuery Graph.

  3. In una cella del notebook, utilizza il comando magico %%bigquery --graph seguito dalla query GQL. La query deve restituire gli 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 singoli nodi e archi.

  4. 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 prestiti rimborsati, 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]->(acount2: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 di nodi e 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 dallo 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 perché 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 del grafico.

Visualizzazione di uno schema del grafico.

Per visualizzare uno schema di BigQuery Graph in un notebook:

  1. In una cella del notebook, esegui il seguente comando per installare la libreria BigQuery Magics:

    !pip install bigquery_magics==0.12.1

  2. Nell'ambiente notebook, assicurati di aver installato la libreria client BigQuery Graph.

  3. In una cella del notebook, utilizza il comando magico %%bigquery --graph seguito dalla query GQL. La query deve restituire gli elementi del grafico in formato JSON utilizzando la TO_JSON funzione.

  4. Esegui la cella. La visualizzazione viene mostrata nell'area di output della cella.

  5. Nell'output della visualizzazione, fai clic su schema Visualizzazione 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 tabellare.

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

Ad esempio, la seguente query non può essere visualizzata perché restituisce valori di 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 ulteriori informazioni, consulta Visualizzare i risultati delle query di BigQuery Graph.

I risultati delle query di BigQuery Graph vengono visualizzati parzialmente

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

Possibile causa: la query restituisce più di 2 MB di dati. Una visualizzazione delle query può mostrare un massimo di 2 MB di dati.

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

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