Créer des requêtes avec l'explorateur de tables

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

Ce document vous explique comment utiliser l'explorateur de tables pour examiner les données d'une table et créer des requêtes d'exploration de données.

À propos de l'explorateur de tables

L'explorateur de tables offre un moyen automatisé d'explorer visuellement les données des tables et de créer des requêtes en fonction de votre sélection de champs de table.

Dans l'explorateur de tables, vous sélectionnez les champs de table à examiner. Vous pouvez sélectionner jusqu'à 10 champs de table à la fois.

L'explorateur de tables affiche les champs sélectionnés sous forme de fiches interactives avec la liste des 10 valeurs les plus courantes pour chaque champ, triées par la colonne count. Vous pouvez interagir avec les fiches en sélectionnant les champs et les valeurs distinctes que vous souhaitez examiner de plus près. L'explorateur de tables crée une requête d'exploration de données en fonction de votre sélection.

Vous pouvez copier cette requête dans une nouvelle requête de l'éditeur de requête ou l'appliquer dans l'explorateur de tables. Lorsque vous appliquez la requête, l'explorateur de tables l'exécute et actualise les fiches affichées avec les résultats de la requête. Pour continuer à explorer les données du tableau, sélectionnez d'autres champs ou valeurs dans les fiches actualisées.

Limites

  • L'explorateur de tables est disponible pour les tables BigQuery, les tables BigLake, les tables externes et les vues.
  • L'explorateur de tables vous permet d'explorer une seule table à la fois. Cette fonctionnalité n'est pas compatible avec l'exploration simultanée de plusieurs tables ni avec la génération d'opérations entre tables (par exemple, les opérations JOIN).
  • L'explorateur de tables crée des requêtes SQL qui reflètent directement votre sélection de champs de table et de valeurs distinctes. Vous pouvez exécuter les requêtes créées par l'explorateur de tables ou les modifier manuellement dans l'éditeur de requête. L'explorateur de tables ne fournit pas d'assistance optimisée par l'IA pour générer, exécuter ou expliquer des requêtes SQL.
  • Pour explorer les données d'une table et générer des requêtes pour les tables avec un contrôle des accès au niveau des colonnes (LCA) ou des autorisations utilisateur limitées, vous devez disposer d'un accès en lecture pour tous les champs sélectionnés. Pour exécuter les requêtes générées, vous devez disposer d'autorisations suffisantes.

Tarifs

L'explorateur de tables exécute des requêtes en fonction de votre sélection de champs de table et de valeurs distinctes pour afficher les résultats de l'exploration de table. Ces requêtes entraînent des frais de calcul. L'explorateur de tables affiche la quantité de données qui sera traitée pour chaque requête avant que vous confirmiez votre sélection de champs de table, ce qui déclenche l'exécution de la requête.

Vous pouvez également encourir des frais de calcul si vous exécutez une requête générée par l'explorateur de tables.

Pour en savoir plus sur les tarifs de calcul BigQuery, consultez la section Tarifs.

Avant de commencer

  1. In the Trusted Cloud console, on the project selector page, select or create a Trusted Cloud project.

    Go to project selector

  2. Verify that billing is enabled for your Trusted Cloud project.

  3. Enable the BigQuery API.

    Enable the API

    4. Rôles et autorisations requis

    Pour obtenir les autorisations nécessaires pour afficher les données de table et générer des requêtes avec l'explorateur de tables, demandez à votre administrateur de vous accorder les rôles IAM suivants :

    Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

    Ces rôles prédéfinis contiennent les autorisations requises pour afficher les données des tables et générer des requêtes avec l'explorateur de tables. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

    Autorisations requises

    Les autorisations suivantes sont requises pour afficher les données des tables et générer des requêtes avec l'explorateur de tables :

    • bigquery.jobs.create sur le projet à partir duquel la requête est exécutée, quel que soit l'emplacement de stockage des données.
    • bigquery.tables.getData sur toutes les tables et vues que vous souhaitez explorer.

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

    Pour en savoir plus sur la gestion de l'authentification et des accès (IAM) dans BigQuery, consultez la page Contrôle des accès avec IAM.

    Explorer les données d'un tableau pour créer une requête

    Pour explorer les données d'une table et créer une requête en fonction de votre sélection de champs et de valeurs de table, procédez comme suit :

    1. Dans la console Trusted Cloud , accédez à BigQuery Studio.

      Accéder à BigQuery Studio

    2. Dans le volet Explorateur, sélectionnez la table pour laquelle vous souhaitez créer une requête.

    3. Cliquez sur l'onglet Explorateur de tables, puis sur Sélectionner des champs.

    4. Dans le volet Sélectionner des champs, sélectionnez jusqu'à 10 champs de table à explorer.

    5. Pour une table partitionnée, définissez un filtre de partitionnement personnalisé dans la section Filtre de partitionnement. Les filtres de partition peuvent réduire le calcul facturable lors de l'exploration des tables.

      1. Sélectionnez Appliquer un filtre de partitionnement personnalisé.

      2. Dans les champs de paramètres affichés, configurez le filtre de partitionnement.

      L'affichage des paramètres de filtre dépend du type de partition de la table : heure, jour, mois, année ou plage.

    6. Cliquez sur Enregistrer.

      Lorsque vous cliquez sur Enregistrer, BigQuery exécute une requête pour afficher les valeurs courantes des champs sélectionnés, ce qui entraîne des frais. Vous pouvez voir la quantité de données qui sera traitée en haut du volet Sélectionner des champs.

      L'explorateur de tables affiche les champs sélectionnés sous forme de fiches dans une liste contenant jusqu'à dix des valeurs les plus courantes, triées par colonne Count. Dans la section Requête générée, vous pouvez voir une requête que vous pouvez exécuter pour afficher les mêmes données.

    7. Facultatif : Pour modifier vos résultats, vous pouvez essayer les options suivantes :

      1. Dans les fiches de champs sélectionnés qui s'affichent, sélectionnez des valeurs distinctes pour filtrer davantage les données.
      2. Pour annuler toutes les modifications, cliquez sur Réinitialiser.
      3. Dans la section Requête générée, cliquez sur Copier dans la requête pour copier le code généré dans une nouvelle requête sans titre dans l'éditeur de requête. Dans l'onglet de requête qui vient d'être créé, vous pouvez modifier, exécuter et gérer la requête.

    8. Pour exécuter la requête générée, cliquez sur Appliquer.

      BigQuery exécute la requête générée et actualise les fiches affichées avec les résultats de la requête.

    9. Pour continuer à explorer la table, sélectionnez de nouveaux champs ou des valeurs distinctes dans les fiches affichées après actualisation.

    Dépannage

    Access Denied: Project [project_id]: User does not have bigquery.jobs.create
permission in project [project_id].

    Cette erreur se produit lorsqu'un compte principal ne dispose pas de l'autorisation nécessaire pour créer des jobs de requête dans le projet.

    Solution : Un administrateur doit vous accorder l'autorisation bigquery.jobs.create sur le projet que vous interrogez. Cette autorisation est requise en plus de toute autorisation requise pour accéder aux données interrogées.

    Pour plus d'informations sur les autorisations BigQuery, consultez la page Contrôle des accès avec IAM.

    Étapes suivantes