Utiliser le modélisateur visuel BigQuery Graph

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

Ce document explique comment utiliser le modélisateur de graphiques visuels dans BigQuery Studio pour définir des nœuds et des arêtes à partir de vos tables BigQuery, et comment modifier et interroger les données graphiques. Vous pouvez également créer un graphique à l'aide de l'instruction CREATE PROPERTY GRAPH.

Rôles requis

Pour obtenir les autorisations nécessaires pour créer et interroger des graphes, demandez à votre administrateur de vous accorder le rôle IAM Éditeur de données BigQuery (roles/bigquery.dataEditor) sur l'ensemble de données dans lequel vous créez les tables de nœuds, les tables d'arêtes et le graphe. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Créer un graphique

Pour créer un graphique à l'aide du modélisateur visuel, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page BigQuery.

    Accéder à BigQuery

  2. Pour ouvrir la galerie, dans la barre d'onglets de l'éditeur, cliquez sur la flèche  à côté de Requête SQL , puis sur Graphique.

  3. Dans le champ Nom du graphique, saisissez un nom pour le graphique.

  4. Dans le champ Destination du graphique dans l'ensemble de données, effectuez l'une des opérations suivantes :

  5. Sélectionnez les tables que vous souhaitez utiliser comme sources de données.

  6. Cliquez sur Créer. BigQuery crée la ressource de graphique et vous redirige vers le modélisateur visuel.

Afficher un graphique

Pour afficher un graphique existant, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page BigQuery.

    Accéder à BigQuery

  2. Dans le volet de navigation, cliquez sur Explorateur :

  3. Dans le volet Explorateur, développez votre projet et cliquez sur Ensembles de données.

  4. Cliquez sur l'ensemble de données contenant votre graphique.

  5. Cliquez sur l'onglet Graphiques.

  6. Sélectionnez le graphique que vous souhaitez afficher.

Modifier un graphique

Une fois que vous avez créé un graphique, vous pouvez utiliser le modélisateur visuel pour ajouter, modifier ou supprimer des nœuds et des arêtes. Les sections suivantes expliquent comment modifier un graphique existant.

Gérer les nœuds

Cette section explique comment gérer les nœuds de graphique.

Ajouter un nœud

Pour ajouter un nœud, procédez comme suit. Les modifications que vous apportez ne sont appliquées que lorsque vous les publiez.

  1. Dans la console Google Cloud , accédez à la page BigQuery.

    Accéder à BigQuery

  2. Dans le volet de navigation, cliquez sur Explorateur :

  3. Dans le volet Explorateur, développez votre projet et cliquez sur Ensembles de données.

  4. Cliquez sur l'ensemble de données contenant votre graphique.

  5. Cliquez sur l'onglet Graphiques.

  6. Sélectionnez le graphique que vous souhaitez modifier.

  7. Dans la barre d'action du graphique, cliquez sur Nouveau nœud.

  8. Dans le panneau Ajouter un nœud, cliquez sur Ajouter une table.

  9. Dans le volet Sélectionner une table, sélectionnez la table de l'ensemble de données que vous souhaitez ajouter, puis cliquez sur Ajouter.

  10. Cliquez sur Modifier la clé primaire.

  11. Sélectionnez les champs que vous souhaitez utiliser comme clés primaires, puis cliquez sur Ajouter.

  12. Facultatif : Cliquez sur Ajouter un libellé.

    1. Dans le champ Nom, saisissez le nom de votre libellé.
    2. Dans le champ Description, saisissez une description de votre libellé.
    3. Dans le champ Synonymes, saisissez jusqu'à huit synonymes.
    4. Cliquez sur Add property (Ajouter une propriété).

    5. Dans le volet Sélectionner des champs, sélectionnez toutes les propriétés que vous souhaitez ajouter au libellé.

      Facultatif : Vous pouvez ajouter un champ personnalisé avec une mesure. Pour en savoir plus, consultez Mesures de graphique.

    6. Cliquez sur Ajouter.

    7. Cliquez sur OK.

  13. Cliquez sur OK.

Modifier un nœud

Pour modifier un nœud, procédez comme suit. Les modifications que vous apportez ne sont appliquées que lorsque vous les publiez.

  1. Dans la console Google Cloud , accédez à la page BigQuery.

    Accéder à BigQuery

  2. Dans le volet de navigation, cliquez sur Explorateur :

  3. Dans le volet Explorateur, développez votre projet et cliquez sur Ensembles de données.

  4. Cliquez sur l'ensemble de données contenant votre graphique.

  5. Cliquez sur l'onglet Graphiques.

  6. Sélectionnez le graphique que vous souhaitez modifier.

  7. Dans le graphique, sélectionnez le nœud que vous souhaitez modifier.

  8. Dans la fenêtre du nœud, cliquez sur Modifier.

  9. Dans le panneau Modifier le nœud, cliquez sur Modifier la clé primaire.

  10. Sélectionnez les champs que vous souhaitez utiliser comme clés primaires, puis cliquez sur Ajouter.

  11. Facultatif : Cliquez sur Ajouter un libellé.

    1. Dans le champ Nom, saisissez le nom de votre libellé.
    2. Dans le champ Description, saisissez une description de votre libellé.
    3. Dans le champ Synonymes, saisissez jusqu'à huit synonymes.
    4. Cliquez sur Add property (Ajouter une propriété).
    5. Dans le volet Sélectionner des champs, sélectionnez toutes les propriétés que vous souhaitez ajouter au libellé.
    6. Cliquez sur Ajouter.
    7. Facultatif : Cliquez sur Ajouter une mesure pour ajouter un champ personnalisé avec une mesure, comme décrit dans Représenter des mesures sous forme de graphiques.
    8. Cliquez sur OK.

  12. Cliquez sur OK.

Supprimer un nœud

Pour supprimer un nœud, procédez comme suit. Les modifications que vous apportez ne sont appliquées que lorsque vous les publiez.

  1. Dans la console Google Cloud , accédez à la page BigQuery.

    Accéder à BigQuery

  2. Dans le volet de navigation, cliquez sur Explorateur :

  3. Dans le volet Explorateur, développez votre projet et cliquez sur Ensembles de données.

  4. Cliquez sur l'ensemble de données contenant votre graphique.

  5. Cliquez sur l'onglet Graphiques.

  6. Sélectionnez le graphique que vous souhaitez modifier.

  7. Dans le graphique, sélectionnez le nœud à supprimer.

  8. Dans la fenêtre "Nœud", cliquez sur Supprimer.

  9. Cliquez sur Supprimer.

Gérer les périphéries

Cette section explique comment gérer les arêtes du graphique.

Ajouter une arête

Pour ajouter un bord, procédez comme suit. Les modifications que vous apportez ne sont appliquées que lorsque vous les publiez.

  1. Dans la console Google Cloud , accédez à la page BigQuery.

    Accéder à BigQuery

  2. Dans le volet de navigation, cliquez sur Explorateur :

  3. Dans le volet Explorateur, développez votre projet et cliquez sur Ensembles de données.

  4. Cliquez sur l'ensemble de données contenant votre graphique.

  5. Cliquez sur l'onglet Graphiques.

  6. Sélectionnez le graphique que vous souhaitez modifier.

  7. Dans la barre d'action du graphique, cliquez sur Nouvelle arête.

  8. Dans le panneau Ajouter une arête, cliquez sur Ajouter une table.

  9. Dans le volet Sélectionner une table, sélectionnez la table que vous souhaitez utiliser comme source de données, puis cliquez sur Ajouter.

  10. Dans la liste Nœud source, sélectionnez le nœud que vous souhaitez utiliser comme source.

  11. Cliquez sur Ajouter des colonnes référencées dans le nœud.

    1. Sélectionnez les champs que vous souhaitez référencer.
    2. Cliquez sur Ajouter.

  12. Dans la liste Nœud cible, sélectionnez le nœud que vous souhaitez utiliser comme cible.

  13. Cliquez sur Ajouter des colonnes référencées dans le nœud.

    1. Sélectionnez les champs que vous souhaitez référencer.
    2. Cliquez sur Ajouter.

  14. Cliquez sur Ajouter des colonnes référencées dans l'arête.

    1. Sélectionnez les champs que vous souhaitez référencer. Le nombre de colonnes et les types de données de ces colonnes d'arêtes doivent correspondre aux colonnes référencées sélectionnées pour les nœuds source et cible.
    2. Cliquez sur Ajouter.

  15. Facultatif : Cliquez sur Ajouter un libellé.

    1. Dans le champ Nom, saisissez le nom de votre libellé.
    2. Dans le champ Description, saisissez une description de votre libellé.
    3. Dans le champ Synonymes, saisissez jusqu'à huit synonymes.
    4. Cliquez sur Add property (Ajouter une propriété).
    5. Dans le volet Sélectionner des champs, sélectionnez toutes les propriétés que vous souhaitez ajouter au libellé.
    6. Cliquez sur Ajouter.
    7. Facultatif : Cliquez sur Ajouter une mesure pour ajouter un champ personnalisé avec une mesure, comme décrit dans Représenter des mesures sous forme de graphiques.
    8. Cliquez sur OK.

  16. Cliquez sur OK.

Modifier une arête

Pour modifier une arête, procédez comme suit. Les modifications que vous apportez ne sont appliquées que lorsque vous les publiez.

  1. Dans la console Google Cloud , accédez à la page BigQuery.

    Accéder à BigQuery

  2. Dans le volet de navigation, cliquez sur Explorateur :

  3. Dans le volet Explorateur, développez votre projet et cliquez sur Ensembles de données.

  4. Cliquez sur l'ensemble de données contenant votre graphique.

  5. Cliquez sur l'onglet Graphiques.

  6. Sélectionnez le graphique que vous souhaitez modifier.

  7. Dans le graphique, sélectionnez l'arête que vous souhaitez modifier.

  8. Dans la fenêtre du nœud, cliquez sur Modifier.

  9. Dans le panneau Modifier l'arête, dans la liste Nœud source, sélectionnez le nœud que vous souhaitez utiliser comme source.

  10. Cliquez sur Ajouter des colonnes référencées dans le nœud.

    1. Sélectionnez les champs que vous souhaitez référencer.
    2. Cliquez sur Ajouter.

  11. Dans la liste Nœud cible, sélectionnez le nœud que vous souhaitez utiliser comme cible.

  12. Cliquez sur Ajouter des colonnes référencées dans le nœud.

    1. Sélectionnez les champs que vous souhaitez référencer.
    2. Cliquez sur Ajouter.

  13. Cliquez sur Ajouter des colonnes référencées dans l'arête.

    1. Sélectionnez les champs que vous souhaitez référencer. Le nombre de colonnes et les types de données de ces colonnes d'arêtes doivent correspondre aux colonnes référencées sélectionnées pour les nœuds source et cible.
    2. Cliquez sur Ajouter.

  14. Facultatif : Cliquez sur Ajouter un libellé.

    1. Dans le champ Nom, saisissez le nom de votre libellé.
    2. Dans le champ Description, saisissez une description de votre libellé.
    3. Dans le champ Synonymes, saisissez jusqu'à huit synonymes.
    4. Cliquez sur Add property (Ajouter une propriété).
    5. Dans le volet Sélectionner des champs, sélectionnez toutes les propriétés que vous souhaitez ajouter au libellé.
    6. Cliquez sur Ajouter.
    7. Facultatif : Cliquez sur Ajouter une mesure pour ajouter un champ personnalisé avec une mesure, comme décrit dans Représenter des mesures sous forme de graphiques.
    8. Cliquez sur OK.

  15. Cliquez sur OK.

Supprimer une arête

Pour supprimer un bord, procédez comme suit. Les modifications que vous apportez ne sont appliquées que lorsque vous les publiez.

  1. Dans la console Google Cloud , accédez à la page BigQuery.

    Accéder à BigQuery

  2. Dans le volet de navigation, cliquez sur Explorateur :

  3. Dans le volet Explorateur, développez votre projet et cliquez sur Ensembles de données.

  4. Cliquez sur l'ensemble de données contenant votre graphique.

  5. Cliquez sur l'onglet Graphiques.

  6. Sélectionnez le graphique que vous souhaitez modifier.

  7. Dans le graphique, sélectionnez l'arête à supprimer.

  8. Dans la fenêtre "Nœud", cliquez sur Supprimer.

  9. Confirmez la suppression.

Publier les modifications apportées au graphique

Pour enregistrer vos modifications, publiez-les dans la ressource graphique. Procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page BigQuery.

    Accéder à BigQuery

  2. Dans le volet de navigation, cliquez sur Explorateur :

  3. Dans le volet Explorateur, développez votre projet et cliquez sur Ensembles de données.

  4. Cliquez sur l'ensemble de données contenant votre graphique.

  5. Cliquez sur l'onglet Graphiques.

  6. Sélectionnez le graphique que vous souhaitez modifier.

  7. Une fois les modifications terminées, cliquez sur Publier.

  8. Examinez l'instruction CREATE PROPERTY GRAPH dans le volet Publier le graphique, puis cliquez sur Publier.

Étapes suivantes