Utiliser l'interface utilisateur Web classique de BigQuery

BigQuery se présente sous la forme de deux interfaces utilisateur Web graphiques qui permettent de créer et de gérer des ressources BigQuery, et d'exécuter des requêtes SQL : l'interface utilisateur Web de BigQuery dans la console GCP et l'interface utilisateur Web classique de BigQuery. Cette page présente l'interface utilisateur Web classique.

Ce document fournit des détails sur l'interface utilisateur Web classique de BigQuery. L'option recommandée est l'interface utilisateur Web de BigQuery dans la console GCP.

Pour obtenir plus d'informations sur l'utilisation des interfaces utilisateur Web, consultez l'une des pages suivantes :

Avant de commencer

Avant de pouvoir utiliser l'interface utilisateur Web classique de BigQuery, vous devez créer ou sélectionner un projet et activer la facturation à l'aide de la console GCP.

  1. Connectez-vous à votre compte Google.

    Si vous n'en possédez pas déjà un, vous devez en créer un.

  2. Select or create a Google Cloud Platform project.

    Go to the Manage resources page

  3. Assurez-vous que la facturation est activée pour votre projet.

    En savoir plus sur l'activation de la facturation

  4. BigQuery est automatiquement activé dans les nouveaux projets. Pour activer BigQuery dans un projet préexistant, Activez BigQueryl'API requise.

    Activer l'API.

Ouvrir l'interface utilisateur Web classique

Pour ouvrir l'interface utilisateur Web classique, saisissez l'URL suivante dans votre navigateur et remplacez project_id par l'identifiant du projet que vous ouvrez dans l'interface utilisateur Web classique :

https://bigquery.cloud.google.com/project_id

Cliquez sur le bouton ci-dessous pour ouvrir l'interface utilisateur Web à partir du dernier projet auquel vous avez accédé.

Accéder à l'UI Web classique

Présentation de l'interface utilisateur Web classique

L'interface utilisateur Web classique comprend trois sections principales :

  1. Le côté gauche de la page (volet de navigation) :

    La partie supérieure du volet de navigation contient une liste d'éléments décrivant l'action à effectuer : saisir une requête, consulter l'historique des requêtes ou consulter l'historique des tâches.

    La partie inférieure du volet de navigation contient une liste des ensembles de données du projet auquel vous avez actuellement accès et des ensembles de données publics BigQuery. La zone de filtre disponible vous permet de filtrer par ID d'ensemble de données ou par libellé.

  2. Le volet Détails :
    Il contient des informations pertinentes sur l'action sélectionnée dans le volet de navigation. Par exemple, si vous cliquez sur un ensemble de données dans le volet de navigation, le volet Détails affiche les informations qui lui sont associées.
  3. La fenêtre Requête :
    Lorsque vous cliquez sur Compose Query (Saisir une nouvelle requête), la fenêtre New Query (Nouvelle requête) est ajoutée au-dessus du volet Details (Détails). Vous pouvez fermer cette fenêtre si vous n'en avez plus besoin.

Capture d'écran de l'interface utilisateur Web BigQuery

Afficher des ressources

Le volet de navigation répertorie les ensembles de données que vous pouvez parcourir dans le projet en cours. Cliquez sur l'icône icône Développer l'ensemble de données en regard d'un ensemble de données ou sur le nom d'un ensemble de données pour le développer et afficher les tables qui lui sont associées.

Vous pouvez cliquer sur une table pour afficher ses informations dans le volet de détails. Vous pouvez ensuite cliquer sur le bouton Exécuter une requête sur la table à droite du volet pour insérer une requête basique pour cette table dans le champ de requête. Vous pouvez modifier la requête manuellement pour spécifier des champs ou la personnaliser à votre gré. Vous pouvez exécuter des requêtes sur des tables autres que celle qui est actuellement sélectionnée. Pour en savoir plus sur l'interrogation de tables, consultez Exécuter des requêtes interactives.

Ajouter et supprimer des projets

Toutes vos tâches BigQuery sont effectuées dans un projet. Le nom de ce projet est visible dans le volet de navigation au-dessus de la liste des ensembles de données. Toutes vos tâches dans le projet sont imputées au compte de facturation associé au projet. Pour en savoir plus sur la facturation BigQuery, consultez la page Tarifs.

Dans l'interface utilisateur Web classique, vous pouvez :

  • ajouter (ou épingler) des projets supplémentaires ;
  • supprimer des projets épinglés ;
  • basculer vers un autre projet.

Ajouter un projet

Vous pouvez ajouter ou "épingler" un projet dans l'interface utilisateur Web classique à l'aide du menu déroulant du projet.

Pour ajouter un projet sur l'interface utilisateur classique, procédez comme suit :

  1. Cliquez sur la flèche vers le bas flèche vers le bas en regard du nom du projet dans le volet de navigation.

  2. Dans le menu déroulant, cliquez sur Changer de projet > Afficher le projet.

  3. Dans la boîte de dialogue Display Project (Afficher le projet) :

    • Saisissez l'ID du projet.
    • Laissez l'option Display project in navigation panel (Afficher le projet dans le volet de navigation) sélectionnée.
    • Cliquez sur OK pour ajouter le projet dans le volet de navigation.

      boîte de dialogue Afficher le projet

Supprimer un projet de l'interface utilisateur classique

Pour supprimer un projet que vous avez précédemment ajouté (ou "épinglé") :

  1. Cliquez sur la flèche vers le bas flèche vers le bas en regard du nom du projet dans le volet de navigation.

  2. Dans le menu déroulant, cliquez sur Supprimer le projet du volet.

Basculer vers un autre projet

Si vous préférez basculer vers un autre projet plutôt que de l'épingler dans l'interface utilisateur, vous pouvez utiliser le menu contextuel.

Pour basculer vers un autre projet, procédez comme suit :

  1. Cliquez sur la flèche vers le bas flèche vers le bas en regard du nom du projet dans le volet de navigation.

  2. Dans le menu déroulant, cliquez sur Changer de projet et sélectionnez le projet dans la liste. Votre projet précédent dans l'interface utilisateur est alors remplacé par celui que vous avez choisi.

Ajouter un ensemble de données partagé

Un autre utilisateur peut partager un ensemble de données avec vous, sans vous donner accès au projet correspondant. Le cas échéant, vous devriez recevoir un e-mail avec le nom du projet qui contient l'ensemble de données partagé. Le projet et l'ensemble de données ne s'affichent pas automatiquement dans l'interface utilisateur classique.

Si vous cliquez sur le lien browser tool indiqué dans l'e-mail, l'interface utilisateur Web s'ouvre avec le projet affiché. Si vous préférez épingler le projet qui contient l'ensemble de données partagé, suivez les étapes pour Ajouter un projet.

Afficher l'historique des tâches et des requêtes

Lorsque vous exécutez des tâches et exécutez des requêtes à l'aide de l'interface utilisateur Web classique, l'historique est conservé dans le volet de navigation. Même si les requêtes sont également un type de tâches, l'historique de requêtes est conservé séparément pour faciliter son utilisation.

Dans l'interface utilisateur, les historiques des tâches et des requêtes incluent toutes les tâches de chargement, d'exportation, de copie et de requête que vous avez enregistrées au cours des six derniers mois (jusqu'à 1 000 entrées). La limite de 1 000 tâches est cumulative pour tous les types de tâches.

Afficher l'historique des tâches

Pour afficher l'historique de vos tâches, vous pouvez effectuer l'une des opérations suivantes :

  • Cliquez sur le lien Historique des tâches dans le volet de navigation.

  • Saisissez l'URL suivante dans votre navigateur :

    https://bigquery.cloud.google.com/jobs/project_id

Vous pouvez répéter une tâche de chargement via l'interface utilisateur Web, mais vous ne pouvez pas répéter une tâche d'exportation ou de copie.

Afficher l'historique des requêtes

Pour afficher l'historique de vos requêtes, vous pouvez effectuer l'une des opérations suivantes :

  • Cliquez sur le lien Historique des requêtes dans le volet de navigation.

  • Saisissez l'URL suivante dans votre navigateur :

    https://bigquery.cloud.google.com/queries/project_id

Vous pouvez répéter une tâche de requête à l'aide de l'interface utilisateur Web.

Rechercher l'historique des tâches et des requêtes

Vous pouvez filtrer (ou rechercher) l'historique de vos requêtes ou de vos tâches pour n'afficher que les tâches spécifiques qui répondent à vos critères. Les résultats affichés se limitent au pool de tâches récupérées par l'interface utilisateur classique. Par défaut, l'interface utilisateur classique vous permet de rechercher les 1 000 tâches les plus récentes.

Pour répertorier toutes les tâches disponibles dans l'historique, utilisez la méthode API jobs.list ou la commande CLI bq ls.

Pour filtrer l'historique de vos requêtes ou de vos tâches, procédez comme suit :

  1. Dans le volet de navigation, cliquez sur Historique des tâches ou Historique des requêtes.
  2. Cliquez sur le menu déroulant "Filtrer les tâches" pour ouvrir le champ d'expression du filtre.
  3. Dans le champ d'expression du filtre :

    • Cliquez sur Tous pour sélectionner un critère de filtrage.
    • Cliquez sur le menu déroulant "Opérateurs" et sélectionnez un opérateur. La liste des opérateurs change en fonction des critères que vous sélectionnez. Par exemple, si vous choisissez un critère de texte, la liste des opérateurs comprend une sous-chaîne et une expression régulière.
    • Saisissez une valeur dans le champ.

      Générateur d'expression de filtre

  4. Cliquez sur And (Et) pour ajouter un critère supplémentaire facultatif au filtre.

  5. Cliquez sur Search (Rechercher).

Pour filtrer des tâches de requête, utilisez l'une des propriétés de tâche suivantes :

  • Indifférent – Toute propriété.
  • ID de tâche (jobid) – ID de tâche unique et opaque.
  • Utilisateur (user) – Utilisateur ayant envoyé la tâche.
  • Heure de début (start) – Heure de début de la tâche, en millisecondes écoulées depuis l'itération. Cette propriété est visible lorsque vous passez la tâche de l'état PENDING à RUNNING ou DONE.
  • Heure de fin (end) – Heure de fin de la tâche, en millisecondes écoulées depuis l'itération. Cette propriété est visible lorsque l'état d'une tâche est DONE.
  • Table de destination (dest) – Nom de la table de destination pour l'opération de la tâche (chargement, copie ou requête).
  • Texte de requête – Texte de la requête SQL envoyée.
  • Octets traités – Nombre total d'octets traités par la requête SQL.
  • Code UDF – Ressource intégrée qui contient le code d'une fonction définie par l'utilisateur (UDF).

Pour filtrer des tâches de chargement, de copie et d'extraction, utilisez l'une des propriétés de tâche suivantes :

  • Indifférent – Toute propriété.
  • ID de tâche (jobid) – ID de tâche unique et opaque.
  • Utilisateur (user) – Utilisateur ayant envoyé la tâche.
  • Heure de début (start) – Heure de début de la tâche, en millisecondes écoulées depuis l'itération. Cette propriété est visible lorsque vous passez la tâche de l'état PENDING à RUNNING ou DONE.
  • Heure de fin (end) – Heure de fin de la tâche, en millisecondes écoulées depuis l'itération. Cette propriété est visible lorsque l'état d'une tâche est DONE.
  • Table de destination (dest) – Nom de la table de destination pour l'opération de la tâche (chargement, copie ou requête).
  • Titre (title) – Titre tel qu'il est affiché dans l'historique. Par exemple, le titre d'une tâche de chargement peut être : "fichier importé dans myproject:mydataset.mytable".
  • Type (type) – Type de tâche : chargement, requête, copie ou extraction (exportation).
  • Source de la copie (copysrc) – Table source d'une tâche de copie.
  • URI de destination (desturi) – URI de destination Cloud Storage pour une tâche d'extraction (exportation).
  • Table source (srctable) – Table source d'une tâche d'extraction.
  • URI source (srcuri) – URI source Cloud Storage pour une tâche de chargement.

Trier l'historique des requêtes

Vous pouvez également trier l'historique de vos requêtes dans l'interface utilisateur classique à l'aide de l'option Sort By (Trier par) dans le volet Queries (Requêtes). Le volet Queries (Requêtes) s'ouvre lorsque vous cliquez sur Query History (Historique des requêtes) dans le volet de navigation.

Bouton "Trier par" pour l'historique des requêtes

Les options de tri sont les suivantes :

  • Date – Trie les requêtes par date d'exécution.
  • Duration (Durée) – Trie les requêtes par durée d'exécution totale.
  • Duration/byte (Durée/octet) – Trie les requêtes par durée, normalisée par des octets d'entrée. Cela vous permet de comparer le temps d'exécution des requêtes avec des entrées de différentes tailles. Par exemple, si vous avez un ensemble de tables qui ne cessent de croître avec le temps, vous pouvez comparer l'efficacité des requêtes en ne tenant pas compte de la différence uniquement due à la modification de la taille des entrées. Cela suppose que la relation entre la taille des entrées et l'environnement d'exécution est linéaire.
  • Input bytes (Octets d'entrée) – Trie les requêtes par octets lus.
  • Slot-ms (Emplacement-ms) – Trie les requêtes en calculant la somme de millisecondes actives sur tous les emplacements utilisés par la requête. Le tri par slot-ms est une mesure plus stable de l'effort de traitement, car il est moins affecté par les retards du système et les autres sources d'incertitude pouvant avoir une incidence sur la durée observée.
  • Slot-ms/byte (Emplacement-ms/octet) – Semblable à l'option "Duration/byte" (Durée/octet), "Slot-ms/byte" (Emplacement-ms/octet) est une forme normalisée de slot-ms.

    Options de tri de l'historique des requêtes

Limites d'affichage de l'interface utilisateur classique

L'interface utilisateur Web classique comporte les limites d'affichage suivantes :

  • Le nombre d'ensembles de données pouvant être affichés dans le volet de navigation est limité à 1 000.
  • Le nombre de tables pouvant être affichées dans le volet de navigation par projet est limité à 30 000.

Contrôler les performances d'affichage de l'interface utilisateur classique

Dans de rares cas, les performances de l'interface utilisateur Web classique peuvent être affectées lorsqu'un projet contient un grand nombre d'ensembles de données avec beaucoup de tables. Pour améliorer les performances de l'interface utilisateur lorsque le projet contient un grand nombre de ressources, utilisez le paramètre ?minimal pour limiter le nombre de ressources affichées à 10 000 tables par projet. Par exemple, saisissez l'URL suivante dans votre navigateur pour limiter le nombre de ressources affichées :

https://bigquery.cloud.google.com/queries/project_id?minimal.

Raccourcis clavier

L'interface utilisateur Web classique prend en charge les raccourcis clavier suivants :

Combinaison de touches (Windows/Linux) Combinaison de touches (Mac OS) Action
Ctrl+Espace Ctrl+Espace Si aucune requête n'est ouverte : saisir une nouvelle requête
Si l'éditeur de requête est ouvert : saisir semi-automatiquement le mot en cours
Ctrl+Entrée Cmd+Entrée Exécuter la requête en cours
Tabulation Tabulation Saisir semi-automatiquement le mot en cours
Ctrl Cmd Mettre en surbrillance les noms de tables
Ctrl+clic sur le nom de la table Cmd+clic sur le nom de la table Ouvrir le schéma de la table
Ctrl+E Cmd+E Exécuter la requête à partir de la sélection
Ctrl+/ Cmd+/ Commenter les lignes en cours ou sélectionnées
Ctrl+Maj+F Cmd+Maj+F Mettre en forme la requête

Exemples

Pour obtenir des exemples d'interface utilisateur Web classique, consultez la section Guides pratiques de la documentation BigQuery. Vous trouverez ci-dessous des liens vers des tâches courantes de l'interface utilisateur Web, par exemple pour exécuter des requêtes et créer, obtenir, répertorier, supprimer et modifier des ressources BigQuery.

Interroger les données

Pour en savoir plus sur l'utilisation de l'interface utilisateur Web classique pour créer et exécuter des requêtes, consultez les sections :

Créer des ressources

Pour en savoir plus sur l'utilisation de l'interface utilisateur Web classique pour créer des ressources, consultez les sections :

Obtenir des informations sur les ressources

Pour en savoir plus sur l'utilisation de l'interface utilisateur Web classique pour obtenir des informations sur les ressources, consultez les sections :

Répertorier des ressources

Pour en savoir plus sur l'utilisation de l'interface utilisateur Web classique pour répertorier des ressources, consultez les sections :

Mettre à jour des ressources

Pour en savoir plus sur l'utilisation de l'interface utilisateur Web classique pour mettre à jour des ressources, consultez les sections :

Charger des données

Pour en savoir plus sur l'utilisation de l'interface utilisateur Web classique pour charger des données, consultez les sections :

Utiliser des sources de données externes

Pour en savoir plus sur l'utilisation de l'interface utilisateur Web classique pour interroger des données dans des sources de données externes, consultez les sections :

Exporter des données

Pour en savoir plus sur l'utilisation de l'interface utilisateur Web classique pour exporter des données, consultez la section :

Utiliser le service de transfert de données BigQuery

Pour en savoir plus sur l'utilisation de l'interface utilisateur Web classique avec le service de transfert de données BigQuery, consultez les sections :

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Besoin d'aide ? Consultez notre page d'assistance.