Ce document explique comment répertorier des vues dans BigQuery.
Vous pouvez répertorier les vues d'ensembles de données de différentes manières :
- En utilisant Cloud Console
- En utilisant la commande
bq ls
de l'outil de ligne de commandebq
- En appelant la méthode API
tables.list
- En utilisant les bibliothèques clientes
Autorisations requises
Pour répertorier les vues d'un ensemble de données, vous devez au minimum disposer des autorisations bigquery.tables.list
. Les rôles IAM prédéfinis suivants incluent les autorisations bigquery.tables.list
:
bigquery.user
bigquery.metadataViewer
bigquery.dataViewer
bigquery.dataOwner
bigquery.dataEditor
bigquery.admin
Pour en savoir plus sur les rôles et les autorisations IAM dans BigQuery, consultez la page Rôles prédéfinis et autorisations.
Répertorier des vues
Le processus permettant de répertorier des vues est le même que pour les tables.
Pour répertorier les vues dans un ensemble de données :
Console
Dans le panneau Explorateur, développez votre projet et sélectionnez un ensemble de données.
Faites défiler la liste pour voir les tables de l'ensemble de données. Les tables et les vues sont identifiées par des icônes différentes.
bq
Exécutez la commande bq ls
. L'option --format
peut être utilisée pour contrôler le résultat. Si vous répertoriez des vues dans un projet autre que votre projet par défaut, ajoutez l'ID du projet à l'ensemble de données, en respectant le format suivant : project_id:dataset
.
bq ls --format=pretty project_id:dataset
Où :
- project_id est l'ID de votre projet.
- dataset est le nom de l'ensemble de données.
Lorsque vous exécutez la commande, le champ Type
affiche TABLE
ou VIEW
. Par exemple :
+-------------------------+-------+----------------------+-------------------+ | tableId | Type | Labels | Time Partitioning | +-------------------------+-------+----------------------+-------------------+ | mytable | TABLE | department:shipping | | | myview | VIEW | | | +-------------------------+-------+----------------------+-------------------+
Exemples :
Saisissez la commande suivante pour répertorier les vues de l'ensemble de données mydataset
dans votre projet par défaut.
bq ls --format=pretty mydataset
Saisissez la commande suivante pour répertorier les vues de l'ensemble de données mydataset
dans myotherproject
.
bq ls --format=pretty myotherproject:mydataset
API
Pour répertorier les vues à l'aide de l'API, appelez la méthode tables.list
.
Go
Avant d'essayer l'exemple ci-dessous, suivez la procédure de configuration pour Go décrite dans le guide de démarrage rapide de BigQuery : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API BigQuery en langage Go.
Python
Avant d'essayer l'exemple ci-dessous, suivez la procédure de configuration pour Python décrite dans le guide de démarrage rapide de BigQuery : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API BigQuery Python.
Étapes suivantes
- Pour en savoir plus sur la création de vues, consultez la page Créer des vues.
- Pour en savoir plus sur la création de vues autorisées, consultez la page Créer des vues autorisées.
- Pour en savoir plus sur l'obtention de métadonnées de vue, consultez la page Obtenir des informations sur les vues.
- Pour en savoir plus sur la mise à jour de vues, consultez la page Mettre à jour les vues.
- Pour en savoir plus sur la gestion des vues, consultez la page Gérer les vues.