Contrôle des accès avec IAM

Cette page fournit des informations sur les rôles et les autorisations Identity and Access Management (IAM) pour BigQuery.

Cette page inclut les rôles et les autorisations correspondant à chacun des produits associés de BigQuery :

• BigQuery ML
• BigQuery Data Transfer Service
• BigQuery BI Engine

Pour en savoir plus sur les contrôles d'accès dans BigQuery ML, consultez la page Contrôle des accès dans la documentation BigQuery ML.

Présentation

Lorsqu'une identité appelle une API Google Cloud, BigQuery exige qu'elle dispose des autorisations appropriées pour accéder à la ressource. Vous pouvez accorder des autorisations en attribuant des rôles à un utilisateur, à un groupe ou à un compte de service.

Cette page décrit les rôles IAM BigQuery que vous pouvez accorder aux identités pour qu'elles puissent accéder aux ressources BigQuery.

Types de rôles IAM

Il existe trois types de rôles dans IAM :

• Les rôles prédéfinis fournissent un accès précis à un service spécifique et sont gérés par Google Cloud. Ils sont conçus pour des cas d'utilisation courants et des modèles de contrôle des accès.
• Les rôles personnalisés fournissent un accès en fonction d'une liste d'autorisations spécifiée par l'utilisateur.

• Les rôles de base incluent les rôles "Propriétaire", "Éditeur" et "Lecteur".

  Attention : Les rôles de base au niveau de l'ensemble de données de BigQuery existaient avant la mise en place d'IAM. Nous vous recommandons de minimiser l'utilisation des rôles de base. Dans les environnements de production, n'attribuez pas de rôles de base, sauf s'il n'existe pas d'autre solution.

Pour déterminer si une ou plusieurs autorisations sont incluses dans un rôle prédéfini, personnalisé ou de base, vous pouvez employer l'une des méthodes suivantes :

• La commande gcloud iam roles describe
• La méthode roles.get() dans l'API IAM

Lorsque vous attribuez des rôles prédéfinis et des rôles de base à un utilisateur, les autorisations accordées correspondent à une combinaison des autorisations de chaque rôle.

Pour en savoir plus sur l'utilisation d'IAM pour accéder aux ressources, consultez la page Accorder, modifier et révoquer les accès à des ressources dans la documentation spécifique à IAM.

Pour en savoir plus sur la création de rôles personnalisés, consultez la page Créer et gérer les rôles personnalisés dans la documentation spécifique à IAM.

Autorisations BigQuery et rôles IAM prédéfinis

Pour accorder l'accès à une ressource BigQuery, attribuez un ou plusieurs rôles à un utilisateur, un groupe ou un compte de service. Vous pouvez accorder l'accès aux niveaux de ressources BigQuery suivants :

• Organisation ou projet Google Cloud
• Niveau de l'ensemble de données
• Niveau de la table ou de la vue

Rôles appliqués au niveau de l'organisation ou du projet Cloud

Lorsque vous attribuez des rôles au niveau de l'organisation et du projet, vous fournissez des autorisations pour exécuter des tâches BigQuery ou pour accéder à toutes les ressources BigQuery d'un projet.

Rôles appliqués au niveau de l'ensemble de données

Vous pouvez également attribuer des rôles au niveau de l'ensemble de données pour ne fournir l'accès qu'à un ensemble de données spécifique, sans fournir un accès complet aux ressources du projet. Dans la hiérarchie des stratégies IAM, les ensembles de données BigQuery sont des ressources enfants de projets. Pour en savoir plus sur l'attribution de rôles au niveau de l'ensemble de données, consultez la page Contrôler l'accès aux ensembles de données.

Rôles appliqués à des ressources individuelles au sein des ensembles de données

Vous pouvez attribuer des rôles individuellement à certains types de ressources dans des ensembles de données, sans fournir un accès complet aux ressources de l'ensemble de données.

Les rôles peuvent être appliqués à des ressources individuelles des types suivants :

• Tables
• Vues

Les rôles ne peuvent pas être appliqués à des ressources individuelles des types suivants :

• Routines
• modèles

Pour en savoir plus sur l'attribution de rôles au niveau de la table ou de la vue, consultez la page Contrôler l'accès aux tables ou aux vues.

Autorisations BigQuery

Le tableau suivant décrit les autorisations disponibles dans BigQuery.

Permission	Description
bigquery.bireservations.get (version bêta)	Consulter les réservations BI Engine.
bigquery.bireservations.update (version bêta)	Mettre à jour les réservations BI Engine.
bigquery.capacityCommitments.create	Créer un engagement de capacité dans le projet
bigquery.capacityCommitments.delete	Supprimer un engagement de capacité.
bigquery.capacityCommitments.get	Récupérer les informations sur un engagement de capacité
bigquery.capacityCommitments.list	Répertorier tous les engagements de capacité dans un projet
bigquery.capacityCommitments.update	Mettre à jour tous les engagements de capacité dans un projet.
bigquery.connections.create	Créer des connexions dans un projet
bigquery.connections.delete	Supprimer une connexion
bigquery.connections.get	Obtenir des métadonnées de connexion. Les identifiants sont exclus.
bigquery.connections.list	Répertorier les connexions d'un projet
bigquery.connections.update	Mettre à jour une connexion et ses identifiants
bigquery.connections.updateTag	Mettre à jour les tags d'une connexion
bigquery.connections.use	Utiliser une configuration de connexion pour se connecter à une source de données distante
bigquery.datasets.create	Créer des ensembles de données vides.
bigquery.datasets.delete	Supprimer un ensemble de données.
bigquery.datasets.get	Obtenir les métadonnées d'un ensemble de données
bigquery.datasets.getIamPolicy	Lire les autorisations IAM d'un ensemble de données.
bigquery.datasets.setIamPolicy	Modifier les autorisations IAM d'un ensemble de données.
bigquery.datasets.update	Mettre à jour les métadonnées d'un ensemble de données
bigquery.datasets.updateTag (version bêta)	Mettre à jour les tags d'un ensemble de données
bigquery.jobs.create	Exécuter des tâches, y compris des requêtes, dans le projet
bigquery.jobs.get	Obtenir les données et les métadonnées de n'importe quelle tâche.^1
bigquery.jobs.list	Répertorier toutes les tâches et récupérer les métadonnées de n'importe quelle tâche envoyée par un utilisateur^1. Les informations et les métadonnées des tâches envoyées par d'autres utilisateurs sont masquées.
bigquery.jobs.listAll	Répertorier toutes les tâches et récupérer les métadonnées de n'importe quelle tâche envoyée par un utilisateur.^1
bigquery.jobs.delete	Supprimez les métadonnées d'une tâche.
bigquery.jobs.update	Annuler n'importe quelle tâche.^1
bigquery.models.create	Créer des modèles.
bigquery.models.delete	Supprimer des modèles.
bigquery.models.getData	Obtenir des données de modèle. Pour obtenir des métadonnées de modèle, vous avez besoin de bigquery.models.getMetadata.
bigquery.models.getMetadata	Obtenir des métadonnées de modèle. Pour obtenir des données de modèle, vous avez besoin de bigquery.models.getData.
bigquery.models.list	Répertorier les modèles et les métadonnées sur les modèles.
bigquery.models.updateData	Mettre à jour les données de modèle. Pour mettre à jour les métadonnées de modèle, vous avez besoin de bigquery.models.updateMetadata.
bigquery.models.updateMetadata	Mettre à jour les métadonnées de modèle. Pour mettre à jour les données de modèle, vous avez besoin de bigquery.models.updateData.
bigquery.models.export	Exporter un modèle
bigquery.readsessions.create	Créer une session de lecture via l'API BigQuery Storage Read.
bigquery.readsessions.getData	Lire des données d'une session de lecture via l'API Storage Read.
bigquery.readsessions.update	Mettre à jour une session de lecture via l'API Storage Read
bigquery.reservations.create	Créer une réservation dans un projet
bigquery.reservations.delete	Supprimer une réservation
bigquery.reservations.get	Récupérer les informations sur une réservation
bigquery.reservations.list	Répertorier toutes les réservations d'un projet.
bigquery.reservations.update	Mettre à jour les propriétés d'une réservation
bigquery.reservationAssignments.create	Créer une attribution de réservation. Cette autorisation est requise pour le projet propriétaire et la ressource affectée. Pour transférer une attribution de réservation, vous avez besoin de bigquery.reservationAssignments.create pour le nouveau projet propriétaire et la ressource affectée.
bigquery.reservationAssignments.delete	Supprimer une attribution de réservation. Cette autorisation est requise pour le projet propriétaire et la ressource affectée. Pour transférer une attribution de réservation, vous avez besoin de bigquery.reservationAssignments.delete pour l'ancien projet propriétaire et la ressource affectée.
bigquery.reservationAssignments.list	Répertorier toutes les attributions de réservation dans un projet.
bigquery.reservationAssignments.search	Rechercher une attribution de réservation pour un projet, un dossier ou une organisation spécifique.
bigquery.rowAccessPolicies.create	Créer une règle d'accès au niveau des lignes dans une table.
bigquery.rowAccessPolicies.delete	Supprimer une règle d'accès au niveau des lignes d'une table.
bigquery.rowAccessPolicies.getFilteredData	Récupère les données d'une table que vous souhaitez afficher uniquement aux comptes principaux de la liste des bénéficiaires d'une règle d'accès au niveau des lignes. Nous vous recommandons d'accorder cette autorisation uniquement sur une ressource de stratégie d'accès au niveau des lignes.
bigquery.rowAccessPolicies.list	Répertorier toutes les règles d'accès au niveau des lignes d'une table.
bigquery.rowAccessPolicies.getIamPolicy	Obtenir les autorisations IAM d'une règle d'accès aux lignes.
bigquery.rowAccessPolicies.setIamPolicy	Définir les autorisations IAM de la règle d'accès aux lignes.
bigquery.rowAccessPolicies.update	Recréer une règle d'accès au niveau des lignes.
bigquery.routines.create	Créer des routines (fonctions et procédures stockées)
bigquery.routines.delete	Supprimer des routines
bigquery.routines.get	Obtenir des définitions et des métadonnées de routine
bigquery.routines.list	Répertorier des routines et leurs métadonnées
bigquery.routines.update	Mettre à jour des définitions et des métadonnées de routine
bigquery.routines.updateTag	Mettre à jour les tags d'une routine
bigquery.savedqueries.create	Créer des requêtes enregistrées
bigquery.savedqueries.delete	Supprimer les requêtes enregistrées.
bigquery.savedqueries.get	Obtenir les métadonnées des requêtes enregistrées.
bigquery.savedqueries.list	Répertorier les requêtes enregistrées.
bigquery.savedqueries.update	Mettre à jour les requêtes enregistrées.
bigquery.tables.create	Créer des tables
bigquery.tables.createSnapshot	Créer des instantanés de table.
bigquery.tables.delete	Supprimer des tables
bigquery.tables.deleteSnapshot	Supprimer des instantanés de table.
bigquery.tables.export	Exporter les données d'une table de BigQuery
bigquery.tables.get	Obtenir les métadonnées d'une table. Pour obtenir des données d'une table, vous avez besoin de bigquery.tables.getData.
bigquery.tables.getData	Obtenir les données d'une table. Cette autorisation est requise pour interroger les données d'une table. Pour obtenir les métadonnées d'une table, vous avez besoin de bigquery.tables.get.
bigquery.tables.getIamPolicy	Lire la stratégie IAM d'une table
bigquery.tables.list	Répertorier des tables et leurs métadonnées
bigquery.tables.restoreSnapshot	Restaurer des instantanés de table.
bigquery.tables.setCategory	Définir des tags avec stratégie dans le schéma de table
bigquery.tables.setIamPolicy	Modifier la stratégie IAM d'une table
bigquery.tables.update	Mettre à jour les métadonnées d'une table. Pour mettre à jour les données d'une table, vous avez besoin de bigquery.tables.updateData.
bigquery.tables.updateData	Mettre à jour les données d'une table. Pour mettre à jour les métadonnées d'une table, vous avez besoin de bigquery.tables.update.
bigquery.tables.updateTag (version bêta)	Mettre à jour les tags d'une table
bigquery.transfers.get	Obtenir des métadonnées de transfert
bigquery.transfers.update	Créer, mettre à jour et supprimer des transferts

¹ Pour chaque tâche que vous créez, vous disposez automatiquement de l'équivalent des autorisations bigquery.jobs.get et bigquery.jobs.update pour cette tâche.

Rôles IAM prédéfinis dans BigQuery

Le tableau suivant répertorie les rôles IAM prédéfinis dans BigQuery, ainsi que la liste de toutes les autorisations incluses dans chaque rôle. Notez que chaque autorisation est applicable à un type de ressource particulier.

Rôle	Autorisations
Administrateur BigQuery (roles/bigquery.admin) Fournit des autorisations permettant de gérer toutes les ressources du projet. Peut gérer toutes les données du projet et annuler des tâches exécutées par d'autres utilisateurs dans le projet. Ressources de niveau inférieur auxquelles vous pouvez attribuer ce rôle : Projet	bigquery.bireservations.* bigquery.capacityCommitments.* bigquery.config.* bigquery.connections.* bigquery.datasets.* bigquery.jobs.* bigquery.models.* bigquery.readsessions.* bigquery.reservationAssignments.* bigquery.reservations.* bigquery.routines.* bigquery.rowAccessPolicies.create bigquery.rowAccessPolicies.delete bigquery.rowAccessPolicies.getIamPolicy bigquery.rowAccessPolicies.list bigquery.rowAccessPolicies.setIamPolicy bigquery.rowAccessPolicies.update bigquery.savedqueries.* bigquery.tables.* bigquery.transfers.* resourcemanager.projects.get resourcemanager.projects.list
Administrateur de connexion BigQuery (roles/bigquery.connectionAdmin)	bigquery.connections.*
Utilisateur de connexion BigQuery (roles/bigquery.connectionUser)	bigquery.connections.get bigquery.connections.getIamPolicy bigquery.connections.list bigquery.connections.use
Éditeur de données BigQuery (roles/bigquery.dataEditor) Lorsque ce rôle est appliqué à une table ou une vue, il fournit des autorisations permettant d'effectuer les opérations suivantes : Lire et mettre à jour les données et les métadonnées de la table ou de la vue Supprimer la table ou la vue Ce rôle ne peut pas être appliqué à des modèles ou des routines individuels. Lorsqu'il est appliqué à un ensemble de données, ce rôle fournit des autorisations permettant d'effectuer les opérations suivantes : Lire les métadonnées de l'ensemble de données et répertorier les tables qu'il contient Créer, mettre à jour, obtenir et supprimer les tables de l'ensemble de données Lorsque ce rôle est appliqué au niveau du projet ou de l'organisation, il peut également créer des ensembles de données. Ressources de niveau inférieur auxquelles vous pouvez attribuer ce rôle : Table Afficher	bigquery.datasets.create bigquery.datasets.get bigquery.datasets.getIamPolicy bigquery.datasets.updateTag bigquery.models.* bigquery.routines.* bigquery.tables.create bigquery.tables.createSnapshot bigquery.tables.delete bigquery.tables.export bigquery.tables.get bigquery.tables.getData bigquery.tables.getIamPolicy bigquery.tables.list bigquery.tables.restoreSnapshot bigquery.tables.update bigquery.tables.updateData bigquery.tables.updateTag resourcemanager.projects.get resourcemanager.projects.list
Propriétaire de données BigQuery (roles/bigquery.dataOwner) Lorsque ce rôle est appliqué à une table ou une vue, il fournit des autorisations permettant d'effectuer les opérations suivantes : Lire et mettre à jour les données et les métadonnées de la table ou de la vue Partager la table ou la vue Supprimer la table ou la vue Ce rôle ne peut pas être appliqué à des modèles ou des routines individuels. Lorsqu'il est appliqué à un ensemble de données, ce rôle fournit des autorisations permettant d'effectuer les opérations suivantes : Lire, mettre à jour et supprimer l'ensemble de données créer, mettre à jour, obtenir et supprimer les tables de l'ensemble de données. Lorsque ce rôle est appliqué au niveau du projet ou de l'organisation, il peut également créer des ensembles de données. Ressources de niveau inférieur auxquelles vous pouvez attribuer ce rôle : Table Afficher	bigquery.datasets.* bigquery.models.* bigquery.routines.* bigquery.rowAccessPolicies.create bigquery.rowAccessPolicies.delete bigquery.rowAccessPolicies.getIamPolicy bigquery.rowAccessPolicies.list bigquery.rowAccessPolicies.setIamPolicy bigquery.rowAccessPolicies.update bigquery.tables.* resourcemanager.projects.get resourcemanager.projects.list
Lecteur de données BigQuery (roles/bigquery.dataViewer) Lorsque ce rôle est appliqué à une table ou une vue, il fournit des autorisations permettant d'effectuer les opérations suivantes : Lire les données et les métadonnées de la table ou de la vue Ce rôle ne peut pas être appliqué à des modèles ou des routines individuels. Lorsqu'il est appliqué à un ensemble de données, ce rôle fournit des autorisations permettant d'effectuer les opérations suivantes : Lire les métadonnées de l'ensemble de données et répertorier les tables qu'il contient Lire les données et les métadonnées des tables de l'ensemble de données Lorsque ce rôle est appliqué au niveau du projet ou de l'organisation, il peut également énumérer tous les ensembles de données du projet. Toutefois, des rôles supplémentaires sont nécessaires pour permettre l'exécution de tâches. Ressources de niveau inférieur auxquelles vous pouvez attribuer ce rôle : Table Afficher	bigquery.datasets.get bigquery.datasets.getIamPolicy bigquery.models.export bigquery.models.getData bigquery.models.getMetadata bigquery.models.list bigquery.routines.get bigquery.routines.list bigquery.tables.createSnapshot bigquery.tables.export bigquery.tables.get bigquery.tables.getData bigquery.tables.getIamPolicy bigquery.tables.list resourcemanager.projects.get resourcemanager.projects.list
Lecteur de données filtrées BigQuery (roles/bigquery.filteredDataViewer) Accès permettant d'afficher les données de table filtrées en fonction d'une règle d'accès aux lignes	bigquery.rowAccessPolicies.getFilteredData
Utilisateur de tâche BigQuery (roles/bigquery.jobUser) Fournit des autorisations permettant d'exécuter des tâches, y compris des requêtes, dans le projet. Ressources de niveau inférieur auxquelles vous pouvez attribuer ce rôle : Projet	bigquery.jobs.create resourcemanager.projects.get resourcemanager.projects.list
Lecteur de métadonnées BigQuery (roles/bigquery.metadataViewer) Lorsque ce rôle est appliqué à une table ou une vue, il fournit des autorisations permettant d'effectuer les opérations suivantes : Lire les métadonnées de la table ou de la vue Ce rôle ne peut pas être appliqué à des modèles ou des routines individuels. Lorsqu'il est appliqué à un ensemble de données, ce rôle fournit des autorisations permettant d'effectuer les opérations suivantes : Répertorier les tables et les vues dans l'ensemble de données Lire les métadonnées des tables et des vues de l'ensemble de données Lorsqu'il est appliqué au niveau du projet ou de l'organisation, ce rôle fournit des autorisations permettant d'effectuer les opérations suivantes : Répertorier tous les ensembles de données et lire les métadonnées de tous les ensembles de données du projet répertorier toutes les tables et vues, et lire les métadonnées de toutes les tables et vues du projet. Des rôles supplémentaires sont nécessaires pour permettre l'exécution de tâches. Ressources de niveau inférieur auxquelles vous pouvez attribuer ce rôle : Table Afficher	bigquery.datasets.get bigquery.datasets.getiamPolicy bigquery.models.getMetadata bigquery.models.list bigquery.routines.get bigquery.routines.list bigquery.tables.get bigquery.tables.getIamPolicy bigquery.tables.list resourcemanager.projects.get resourcemanager.projects.list
Utilisateur de sessions de lecture BigQuery (roles/bigquery.readSessionUser) Accès permettant de créer et d'utiliser des sessions de lecture	bigquery.readsessions.* resourcemanager.projects.get resourcemanager.projects.list
Administrateur de ressources BigQuery (roles/bigquery.resourceAdmin) Gérer toutes les ressources BigQuery.	bigquery.bireservations.* bigquery.capacityCommitments.* bigquery.jobs.get bigquery.jobs.list bigquery.jobs.listAll bigquery.reservationAssignments.* bigquery.reservations.* recommender.bigqueryCapacityCommitmentsInsights.* recommender.bigqueryCapacityCommitmentsRecommendations.* resourcemanager.projects.get resourcemanager.projects.list
Éditeur de ressources BigQuery (roles/bigquery.resourceEditor) Gérer toutes les ressources BigQuery, sans pouvoir prendre de décisions d'achat.	bigquery.bireservations.get bigquery.capacityCommitments.get bigquery.capacityCommitments.list bigquery.jobs.get bigquery.jobs.list bigquery.jobs.listAll bigquery.reservationAssignments.* bigquery.reservations.* resourcemanager.projects.get resourcemanager.projects.list
Lecteur de ressources BigQuery (roles/bigquery.resourceViewer) Afficher toutes les ressources BigQuery sans pouvoir apporter de modifications ou prendre de décisions d'achat.	bigquery.bireservations.get bigquery.capacityCommitments.get bigquery.capacityCommitments.list bigquery.jobs.get bigquery.jobs.list bigquery.jobs.listAll bigquery.reservationAssignments.list bigquery.reservationAssignments.search bigquery.reservations.get bigquery.reservations.list resourcemanager.projects.get resourcemanager.projects.list
Utilisateur BigQuery (roles/bigquery.user) Lorsqu'il est appliqué à un ensemble de données, ce rôle permet d'en lire les métadonnées et d'en répertorier les tables. Lorsqu'il est appliqué à un projet, ce rôle permet également d'exécuter des tâches, telles que des requêtes, au sein du projet. Un compte principal doté de ce rôle peut énumérer ou annuler ses propres tâches et énumérer les ensembles de données d'un projet. En outre, ce rôle permet la création de nouveaux ensembles de données au sein du projet. Le créateur dispose alors du rôle de propriétaire de données BigQuery (roles/bigquery.dataOwner) sur ces nouveaux ensembles de données. Ressources de niveau inférieur auxquelles vous pouvez attribuer ce rôle : Ensemble de données	bigquery.bireservations.get bigquery.capacityCommitments.get bigquery.capacityCommitments.list bigquery.config.get bigquery.datasets.create bigquery.datasets.get bigquery.datasets.getIamPolicy bigquery.jobs.create bigquery.jobs.list bigquery.models.list bigquery.readsessions.* bigquery.reservationAssignments.list bigquery.reservationAssignments.search bigquery.reservations.get bigquery.reservations.list bigquery.routines.list bigquery.savedqueries.get bigquery.savedqueries.list bigquery.tables.list bigquery.transfers.get resourcemanager.projects.get resourcemanager.projects.list

Rôles personnalisés BigQuery

Pour créer un rôle IAM personnalisé pour BigQuery, suivez les étapes décrites dans la documentation sur les rôles personnalisés d'IAM.

Rôles de base BigQuery

Pour en savoir plus sur les rôles de base pour BigQuery, consultez la page Rôles de base et autorisations BigQuery.

Étape suivante

• Consultez les exemples de contrôle des accès dans BigQuery.
• Pour en savoir plus sur l'attribution de rôles au niveau de l'ensemble de données, consultez la page Contrôler l'accès aux ensembles de données.
• Pour en savoir plus sur l'attribution de rôles au niveau de la table ou de la vue, consultez la page Contrôler l'accès aux tables ou aux vues.