Visualiser des graphiques

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Pour demander de l'aide ou envoyer des commentaires concernant cette fonctionnalité, envoyez un e-mail à l'adresse [e-mail].

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

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

Visualiser les résultats des requêtes BigQuery Graph

Vous pouvez utiliser la console Google Cloud pour visualiser les résultats des requêtes BigQuery Graph dans BigQuery Studio. Pour visualiser une requête avec BigQuery Graph, celle-ci doit renvoyer des éléments de graphique au format JSON à l'aide de la fonction TO_JSON. Nous vous recommandons de renvoyer des chemins de graphe plutôt que des nœuds et des arêtes individuellement. Les chemins de retour offrent les avantages suivants :

• Les chemins contiennent des données complètes sur les nœuds et les arêtes. Il est possible que certains nœuds et arêtes intermédiaires d'une visualisation d'une requête complexe ne soient pas disponibles si vous renvoyez des nœuds et des arêtes individuels.

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

L'exemple de requête suivant renvoie les chemins des transferts de compte, que vous pouvez visualiser :

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;

Pour visualiser vos résultats, cliquez sur Graphique dans le volet Résultats de la requête. Le panneau d'informations affiche un récapitulatif des libellés de nœuds et d'arêtes, avec le nombre de chacun. Cliquez sur un nœud ou un bord pour parcourir le graphique et afficher les propriétés, les voisins et les connexions. Vous pouvez également afficher les résultats de la requête sous forme de tableau ou basculer vers une visualisation du schéma de graphique sous-jacent.

Pour en savoir plus, consultez Renvoyer des éléments de graphique au format JSON.

Choisir les options de visualisation des résultats de requête

Vous pouvez modifier l'apparence de vos nœuds dans une visualisation de requête. Par exemple, vous pouvez spécifier la mise en page de la visualisation de votre requête, la couleur de vos nœuds et la propriété qui apparaît sur chaque nœud.

Les mises à jour de l'affichage des résultats de requête concernent la session de visualisation des résultats de requête en cours. Les modifications apportées à vos options de visualisation ne sont pas conservées si vous exécutez à nouveau la même requête.

Choisir une mise en page pour une visualisation de graphique BigQuery

Le menu du panneau de visualisation propose les options de mise en page suivantes :

• Mise en page forcée (par défaut) : présente les nœuds sous forme de points qui se repoussent mutuellement, tandis que les nœuds connectés se rapprochent, simulant des forces physiques pour créer une mise en page visuellement intuitive.

• Hiérarchique : positionne les nœuds pour créer une hiérarchie visuelle basée sur la connectivité.

• Séquentiel : positionne les nœuds pour créer une séquence visuelle basée sur la connectivité.

• Afficher les libellés : affiche tous les libellés de nœuds et d'arêtes sur le graphique à tous les niveaux de zoom.

Choisissez la propriété de nœud ou d'arête à afficher.

Par défaut, un nœud ou un bord affiche sa première propriété. Si vous souhaitez qu'un nœud ou un bord affiche une autre propriété, procédez comme suit :

1. Lorsque vous affichez une visualisation des résultats d'une requête BigQuery Graph, cliquez sur Passer à la vue Schéma dans l'onglet Résultats du panneau des résultats de la requête.

   

2. Dans la visualisation du schéma, cliquez sur un nœud ou un bord du type que vous souhaitez modifier.

3. Dans le panneau de détails qui s'affiche pour le nœud ou le point d'accès sélectionné, cliquez sur la propriété que vous souhaitez afficher. Tous les nœuds ou arêtes des résultats de requête qui sont du type de nœud ou d'arête que vous avez sélectionné affichent la propriété que vous avez sélectionnée.

Choisir la couleur de vos nœuds

1. Lorsque vous affichez une visualisation des résultats d'une requête BigQuery Graph, cliquez sur Passer à la vue Schéma dans l'onglet Résultats du panneau des résultats de la requête.

2. Dans la visualisation du schéma, cliquez sur un nœud du type que vous souhaitez mettre à jour.

3. Dans le panneau de détails qui s'affiche pour le nœud sélectionné, cliquez sur Options d'affichage des nœuds.

4. Cliquez sur une couleur. Tous les nœuds des résultats de votre requête qui sont du type de nœud que vous avez sélectionné s'affichent avec la couleur de votre choix.

Choisir les nœuds à afficher

Pour choisir les nœuds à afficher dans une visualisation, procédez comme suit :

1. Dans la visualisation de la requête, effectuez un clic droit sur un nœud.

2. Cliquez sur l'une des options de menu suivantes pour modifier l'état visible du graphique :

   • Développer affiche les nœuds adjacents en parcourant toutes les arêtes entrantes et sortantes, ou en filtrant par type d'arête spécifique.

   • L'option Réduire élague la vue actuelle en masquant tous les nœuds connectés au nœud cible à l'aide d'arêtes entrantes, d'arêtes sortantes ou d'un type d'arête spécifique.

   • L'option Masquer le nœud supprime le nœud cible de la vue actuelle.

   • L'option Afficher uniquement les voisins masque tous les nœuds du graphique, à l'exception du nœud cible et de ceux qui y sont directement connectés.

   • Mettre en surbrillance le nœud met en évidence le nœud cible.

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 éléments du graphique aux données des tables BigQuery. 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 la façon dont ils sont connectés. Cela peut être utile pour les graphiques complexes, car cela permet d'obtenir une vue claire des relations qui pourraient être difficiles à déduire des instructions LDD seules.

Pour visualiser un schéma de graphique, procédez comme suit :

1. Dans BigQuery Studio, accédez au panneau Explorateur.
2. Développez l'ensemble de données contenant votre graphique, développez Graphiques, puis sélectionnez votre graphique.
3. Cliquez sur l'onglet Graph (Graphique).

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

Vous pouvez visualiser les résultats des 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 que Magics IPython.

Visualiser les résultats des requêtes graphiques

Pour visualiser les résultats d'une requête 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 de commandes magiques BigQuery :

   !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 fonction TO_JSON. Nous vous recommandons de renvoyer des chemins de graphe plutôt que des nœuds et des arêtes individuels. Les chemins de retour offrent les avantages suivants :

   • Les chemins contiennent des données complètes sur les nœuds et les 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 les transferts entre les comptes, 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]->(account2: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 d'informations affiche un récapitulatif des libellés de nœuds et d'arêtes, avec le nombre de chacun. Cliquez sur un nœud ou un bord 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.

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 du 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 permet d'obtenir 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.

Pour afficher la 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 de commandes magiques BigQuery :

   !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 fonction TO_JSON.

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

5. Dans le résultat de la visualisation, cliquez sur schéma Affichage 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 à la visualisation des graphiques BigQuery et à comprendre leur comportement.

Aucune visualisation n'apparaît pour une requête BigQuery Graph

Problème : Vous exécutez une requête BigQuery Graph, mais elle n'apparaît qu'au format 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 :

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

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

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

Cause possible : Si vous utilisez une visualisation de notebook, la requête renvoie plus de 2 Mo de données. La visualisation d'un notebook est limitée à 2 Mo, tandis que la visualisation de la console Google Cloud n'est pas limitée.

Solution : Si vous utilisez un notebook, simplifiez la requête pour renvoyer moins de 2 Mo de données ou utilisez la console Google Cloud pour visualiser les résultats.

Certains éléments de graphique ne s'affichent pas dans une visualisation BigQuery Graph

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

Cause possible : la requête utilisée pour créer la visualisation du 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.

Étapes suivantes

• En savoir plus sur BigQuery Graph
• Découvrez comment créer et interroger un graphique.
• En savoir plus sur les outils et les intégrations de visualisation de graphiques