Visualiser des graphiques

Pour demander de l'aide ou envoyer des commentaires sur cette fonctionnalité, envoyez un e-mail à bq-graph-preview-support@google.com.

Les visualisations de graphiques BigQuery affichent les éléments de graphique renvoyés par une requête ou les éléments d'un schéma de graphique. Vous pouvez visualiser des graphiques dans un environnement de notebook, tel que BigQuery Studio, Google Colab, ou Jupyter Notebook.

Une visualisation vous aide à comprendre comment les points de données (nœuds) sont connectés (arêtes). Bien qu'une table de centaines de points de données puisse être difficile à interpréter, sa visualisation de graphique peut révéler des tendances, des dépendances et des anomalies.

Visualiser les résultats de requêtes et les schémas dans un environnement de notebook

Vous pouvez visualiser les résultats de requêtes de graphiques et les schémas de graphiques dans des environnements de notebook tels que BigQuery Studio, Google Colab et Jupyter Notebook. La visualisation est implémentée en tant qu'IPython Magics.

Visualiser les résultats de requêtes de graphiques

Pour visualiser les résultats de requêtes dans un notebook, procédez comme suit :

  1. Dans une cellule de notebook, exécutez la commande suivante pour installer la dernière bibliothèque BigQuery magics :

    !pip install bigquery_magics==0.12.1

  2. Dans votre environnement de notebook, assurez-vous que la bibliothèque cliente BigQuery Graph est installée.

  3. Dans une cellule de notebook, utilisez la commande magique %%bigquery --graph suivie de votre requête GQL. La requête doit renvoyer des éléments de graphique au format JSON à l'aide de la TO_JSON fonction. Nous vous recommandons de renvoyer des chemins de graphique plutôt que des nœuds et des arêtes individuels. Le renvoi de chemins présente les avantages suivants :

    • Les chemins contiennent des données complètes de nœuds et d'arêtes. Si vous renvoyez des nœuds et des arêtes individuels, certains nœuds et arêtes intermédiaires de la visualisation d'une requête complexe peuvent ne pas être disponibles.

    • Si vous renvoyez des chemins, votre instruction RETURN est moins complexe que si vous renvoyez des nœuds et des arêtes individuels.

  4. Exécutez le code de la cellule. La visualisation s'affiche dans la zone de sortie de la cellule.

L'exemple de requête suivant recherche une personne, ses comptes et ses prêts remboursés, puis renvoie les résultats dans 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;

Une fois la requête exécutée, la zone de sortie affiche la visualisation. Le panneau de détails affiche un résumé des libellés de nœuds et d'arêtes avec le nombre de chacun. Cliquez sur un nœud ou une arête pour parcourir le graphique et afficher les propriétés, les voisins et les connexions. L'image suivante montre les propriétés, les voisins et les connexions.

Visualisation des résultats de la requête.

Visualiser un schéma BigQuery Graph

La structure d'un graphique, y compris ses nœuds, ses arêtes, ses libellés et ses propriétés, est définie par son schéma, qui mappe les données des tables BigQuery aux éléments de graphique. La définition du graphique est stockée dans un schéma que vous créez à l'aide de tables d'entrée.

Vous pouvez visualiser les graphiques que vous créez avec un schéma. La visualisation du schéma vous aide à comprendre la structure de votre graphique, y compris les types de nœuds et d'arêtes qu'il contient, ainsi que leurs connexions. Cela peut être utile pour les graphiques complexes, car cela fournit une vue claire des relations qui peuvent être difficiles à déduire à partir des instructions LDD que vous avez utilisées pour créer le graphique. L'image suivante montre un exemple de visualisation de schéma de graphique.

Visualisation d&#39;un schéma de graphique.

Pour afficher une visualisation d'un schéma BigQuery Graph dans un notebook, procédez comme suit :

  1. Dans une cellule de notebook, exécutez la commande suivante pour installer la bibliothèque BigQuery magics :

    !pip install bigquery_magics==0.12.1

  2. Dans votre environnement de notebook, assurez-vous que la bibliothèque cliente BigQuery Graph est installée.

  3. Dans une cellule de notebook, utilisez la commande magique %%bigquery --graph suivie de votre requête GQL. La requête doit renvoyer des éléments de graphique au format JSON à l'aide de la TO_JSON fonction.

  4. Exécutez le code de la cellule. La visualisation s'affiche dans la zone de sortie de la cellule.

  5. Dans la sortie de la visualisation, cliquez sur schema Schema view (Vue du schéma).

Résoudre les problèmes liés aux visualisations de graphiques BigQuery

Les informations suivantes peuvent vous aider à résoudre les problèmes liés aux visualisations de graphiques BigQuery et à comprendre leur comportement.

Une visualisation ne s'affiche pas pour une requête BigQuery Graph

Problème : Vous exécutez une requête BigQuery Graph, mais elle n'apparaît qu'au format de tableau.

Cause possible : La requête ne renvoie pas d'éléments de graphique au format JSON.

Par exemple, la requête suivante ne peut pas être visualisée, car elle renvoie des valeurs de propriété au lieu d'éléments de graphique au format JSON :

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

Solution:

Renvoyez des éléments de graphique au format JSON à l'aide de TO_JSON. Pour en savoir plus, consultez Visualiser les résultats de requêtes BigQuery Graph.

Les résultats de requêtes BigQuery Graph sont partiellement visualisés

Problème : La visualisation d'un résultat de requête n'affiche qu'une partie des résultats de la requête.

Cause possible : La requête renvoie plus de 2 Mo de données. Une visualisation de requête peut afficher un maximum de 2 Mo de données.

Solution : Simplifiez la requête pour renvoyer moins de 2 Mo de données.

Certains éléments de graphique ne sont pas affichés dans une visualisation de graphique BigQuery

Problème : Une visualisation inclut tous les nœuds et arêtes renvoyés, mais certains éléments de graphique ne sont pas affichés.

Cause possible : La requête utilisée pour créer la visualisation de graphique BigQuery renvoie des nœuds et des arêtes individuels au lieu d'un chemin de graphique.

Solution : Mettez à jour la requête pour renvoyer un chemin de graphique.

Étape suivante