Ce document fournit une documentation de référence sur les autorisations IAM (Identity and Access Management) pour les ressources Knowledge Catalog. Utilisez ces autorisations pour créer des rôles personnalisés ou pour vérifier l'accès précis requis pour la gestion des métadonnées, les analyses de données, les opérations de lac, les tâches et les environnements.
Autorisations et rôles
Vous n'accordez pas directement d'autorisations aux utilisateurs. Vous leur accordez plutôt des rôles auxquels sont associées une ou plusieurs autorisations. Cette approche s'aligne sur le principe du moindre privilège, qui vous encourage à n'accorder que l'accès nécessaire à un utilisateur ou à un compte de service pour effectuer ses tâches.
IAM propose des rôles prédéfinis pour les cas d'utilisation courants. Si ces rôles prédéfinis ne répondent pas à vos besoins spécifiques, vous pouvez créer vos propres rôles personnalisés contenant uniquement les autorisations spécifiques requises.
Pour en savoir plus sur les rôles Knowledge Catalog prédéfinis et les autorisations qu'ils contiennent, consultez Rôles IAM Knowledge Catalog.
Pour une description détaillée d'IAM et de ses fonctionnalités, consultez la documentation IAM.
Autorisations de définition et d'obtention de stratégie IAM
Le tableau suivant répertorie les autorisations requises pour obtenir et définir des autorisations IAM :
| Ressource | Méthode API | Autorisation IAM |
|---|---|---|
| Types d'aspects | GetIamPolicy |
dataplex.aspectTypes.getIamPolicy |
| Types d'aspects | SetIamPolicy |
dataplex.aspectTypes.setIamPolicy |
| Groupes d'entrées | GetIamPolicy |
dataplex.entryGroups.getIamPolicy |
| Groupes d'entrées | SetIamPolicy |
dataplex.entryGroups.setIamPolicy |
| Types d'entrées | GetIamPolicy |
dataplex.entryTypes.getIamPolicy |
| Types d'entrées | SetIamPolicy |
dataplex.entryTypes.setIamPolicy |
| Lacs | GetIamPolicy |
dataplex.lakes.getIamPolicy |
| Lacs | SetIamPolicy |
dataplex.lakes.setIamPolicy |
Autorisations de gestion des métadonnées
L'ensemble d'autorisations requis pour effectuer des opérations sur les types d'entrées, les types de liens d'entrée, les types d'aspects, les groupes d'entrées, les entrées et les liens d'entrée dépend du fait que les ressources sont des ressources système ou des ressources personnalisées. Les ressources système sont définies par Knowledge Catalog, et les ressources personnalisées sont définies par vous ou votre organisation.
Pour enrichir les entrées et les liens d'entrée avec des informations supplémentaires, vous pouvez associer des aspects.
Pour effectuer des opérations liées à plusieurs ressources (par exemple, créer une entrée d'un type d'entrée particulier ou ajouter un aspect d'un type d'aspect particulier à une entrée ou à un lien d'entrée), vous aurez peut-être besoin de plusieurs autorisations associées aux ressources.
Types d'entrées
Pour créer et gérer des types d'entrées, vous devez disposer au moins des autorisations standards create, get, list, update et delete.
Lorsque vous créez un type d'entrée, vous devez disposer des autorisations nécessaires pour utiliser chaque type d'aspect que vous souhaitez marquer comme obligatoire pour ce type d'entrée.
Pour utiliser un type d'entrée (par exemple, pour créer des entrées d'un type d'entrée), vous devez disposer de l'autorisation use sur le type d'entrée.
Le tableau suivant recense les autorisations requises pour effectuer des opérations sur les types d'entrées :
| Opération | Autorisation IAM |
|---|---|
Create entry types |
|
Delete entry types |
|
Get entry types |
dataplex.entryTypes.get |
List entry types |
dataplex.entryTypes.list |
Update entry types |
|
|
Utiliser des types d'entrées (lors de la création d'entrées, de la mise à jour des champs d'entrée de premier niveau et des valeurs de type d'aspect requises) |
|
Types d'aspects
Pour créer et gérer des types d'aspects, vous devez disposer des autorisations standards create, get, list, update et delete.
Pour utiliser un type d'aspect (par exemple, pour l'associer en tant qu'aspect facultatif sur une entrée ou mettre à jour l'aspect requis sur le lien de l'entrée), vous devez disposer de l'autorisation use sur le type d'aspect.
Les types d'aspects sont classés en types d'aspects système et types d'aspects personnalisés. Les types d'aspects système sont créés par Knowledge Catalog, et les types d'aspects personnalisés sont créés par vous ou votre organisation. Les types d'aspects système sont ensuite classés en deux catégories : utilisables et en lecture seule. Pour en savoir plus, consultez Catégories de types d'aspects.
Le tableau suivant recense les autorisations requises pour utiliser des types d'aspects personnalisés et système :
| Opération | Autorisations requises pour les types d'aspects personnalisés | Autorisations requises pour les types d'aspect système utilisables | Autorisations requises pour les types d'aspects système en lecture seule |
|---|---|---|---|
Create aspect types |
dataplex.aspectTypes.create |
Non applicable | Non applicable |
Delete aspect types |
dataplex.aspectTypes.delete |
Non applicable | Non applicable |
Get aspect types |
dataplex.aspectTypes.get |
Accordé à allUsers |
Accordé à allUsers |
List aspect types |
dataplex.aspectTypes.list |
Non applicable | Non applicable |
| Lorsque vous créez ou mettez à jour des entrées, définissez des valeurs de type d'aspect facultatives |
|
|
Non applicable |
| Lors de la création ou de la mise à jour d'entrées, définissez les valeurs de type d'aspect requises |
|
|
Non applicable |
Update aspect types |
dataplex.aspectTypes.update |
N/A | N/A |
| Définir les valeurs de type d'aspect requises lors de la création ou de la mise à jour d'un lien d'entrée | N/A |
|
N/A |
Groupes d'entrées
Pour créer et gérer des groupes d'entrées, vous devez disposer des autorisations standards create, get, list, update et delete.
Les groupes d'entrées sont classés en groupes d'entrées système, créés par Knowledge Catalog, et en groupes d'entrées personnalisés, créés par vous ou votre organisation. Pour en savoir plus, consultez Catégories de groupes d'entrées.
Le tableau suivant recense les autorisations requises pour utiliser des groupes d'entrées :
| Opération | Autorisations requises pour les groupes d'entrées personnalisés | Autorisations requises pour les groupes d'entrées système (commençant par @) |
|---|---|---|
Create entry groups |
dataplex.entryGroups.create |
Non applicable |
Delete entry groups |
dataplex.entryGroups.delete |
Non applicable |
Get entry groups |
dataplex.entryGroups.get |
dataplex.entryGroups.get |
List entry groups |
dataplex.entryGroups.list |
dataplex.entryGroups.list |
Update entry groups |
dataplex.entryGroups.update |
Non applicable |
Entrées
Pour créer et gérer des entrées, vous devez disposer des autorisations standards create, get, list, update et delete.
Veuillez noter les points suivants :
- Pour les méthodes de recherche (
<code>LookupEntry</code>) et de recherche (<code>SearchEntries</code>), l'autorisation du système source d'origine est requise sur l'entrée. Par exemple, si la source est une table BigQuery, vous devez disposer de l'autorisationbigquery.tables.getpour afficher les métadonnées et de l'autorisationbigquery.tables.getDatapour afficher les aspects des données. - Si l'autorisation d'afficher les aspects de données n'est pas présente, les entrées sont toujours visibles, mais le contenu des aspects de données est masqué.
- Lorsque vous créez une entrée ou mettez à jour les champs de premier niveau d'une entrée, vous devez disposer de l'autorisation
usesur le type d'entrée. - Lorsque vous créez ou mettez à jour un aspect obligatoire, vous devez disposer de l'autorisation
usesur le type d'entrée d'une entrée, ainsi que sur le type d'aspect sous-jacent. En effet, les aspects requis sont appliqués par le type d'entrée. - Lorsque vous créez, mettez à jour ou supprimez un aspect facultatif, vous devez disposer de l'autorisation
usesur le type d'aspect d'un aspect. - Lorsque vous effectuez un upsert sur une entrée (
<code>UpdateEntry</code>avec<code>allow_missing = True</code>), vous devez disposer de l'autorisationcreate.
Pour en savoir plus sur les types d'entrées sur lesquels les entrées sont basées, consultez Catégories de types d'entrées.
Le tableau suivant recense les autorisations requises pour effectuer des opérations sur les entrées :
| Opération | Entrée basée sur un type d'entrée personnalisé | Entrée basée sur un type d'entrée système utilisable | Entrée basée sur le type d'entrée système en lecture seule |
|---|---|---|---|
Create entries |
|
|
Non applicable |
Get entries |
Pour afficher les aspects de données, |
Pour afficher les aspects de données, |
Pour afficher les aspects de données, |
List entries |
dataplex.entries.list |
dataplex.entries.list |
dataplex.entries.list |
Lookup entries |
Nécessite l'autorisation de lecture des métadonnées du système source. L'autorisation de lire les données du système source est requise pour afficher les aspects de données. Pour les entrées personnalisées, où Knowledge Catalog est traité comme le système source, ces autorisations sont respectivement |
Nécessite l'autorisation de lecture des métadonnées du système source. L'autorisation de lire les données du système source est requise pour afficher les aspects de données. Pour les entrées personnalisées, où Knowledge Catalog est traité comme le système source, ces autorisations sont respectivement |
Nécessite l'autorisation de lecture des métadonnées du système source. L'autorisation de lire les données du système source est requise pour afficher les aspects de données. Pour les entrées personnalisées, où Knowledge Catalog est traité comme le système source, ces autorisations sont respectivement |
Search entries |
Autorisation de lecture du système source d'origine. Pour les entrées personnalisées, il s'agit de |
Autorisation de lecture du système source d'origine. Pour les entrées personnalisées, il s'agit de |
Autorisation de lecture du système source d'origine. Pour les entrées personnalisées, il s'agit de |
Update entries |
|
|
Les champs de premier niveau et les aspects obligatoires ne peuvent pas être modifiés. |
Liens d'entrée
Pour créer et gérer des liens d'entrée, vous devez disposer des autorisations create, get, list et delete sur dataplex.entryLinks.
Veuillez noter les points suivants :
- La création de liens d'entrée (
CreateEntryLink) nécessite également des autorisations sur le type de lien d'entrée et des autorisations sur les entrées spécifiques au lien. - Lorsque vous créez un lien d'entrée avec un aspect obligatoire, vous devez disposer des autorisations nécessaires pour utiliser le type d'aspect.
- Lorsque vous effectuez un upsert sur un lien d'entrée (
UpdateEntryLinkavecallow_missing = True), vous devez également disposer des mêmes autorisations que pourCreateEntryLink.
Le tableau suivant recense les autorisations requises pour effectuer des opérations sur les liens d'entrée :
| Opération | Autorisation IAM |
|---|---|
| Créer des liens d'entrée |
Autorisations requises en fonction du type de lien d'entrée :
Autorisation d'utiliser le type de lien d'entrée :
Autorisations pour tous les aspects requis spécifiés par le type de lien d'entrée :
|
| Supprimer des liens d'entrée | dataplex.entryLinks.delete (sur le groupe d'entrées) |
| Obtenir des liens d'entrée |
|
| Liens de recherche d'entrée |
Nécessite l'autorisation de lecture des métadonnées du système source sur l'entrée pour laquelle les liens d'entrée sont recherchés. Pour les entrées personnalisées associées, où Knowledge Catalog est traité comme le système source, l'autorisation est Pour les entrées de système associé, l'autorisation est l'autorisation de lecture du système source de l'entrée associée. |
| Mettre à jour le lien de l'entrée |
Autorisation d'utiliser le type de lien d'entrée :
Autorisations pour tous les aspects requis spécifiés par le type de lien d'entrée :
Si |
Limites concernant les aspects sur les liens d'entrée
Les limites suivantes s'appliquent à l'utilisation d'aspects avec des liens d'entrée.
Ensembles de contexte
Les ensembles de contexte sont des conteneurs limités d'éléments de données cibles et de métadonnées utilisés pour ancrer les modèles d'IA dans votre logique métier propriétaire. Bien qu'ils puissent contenir des informations spécifiques à la base de données, telles que des modèles de requête SQL ou des requêtes de recherche de valeurs pour les outils de conversion de texte en SQL comme QueryData, Knowledge Studio utilise également des ensembles de contexte pour héberger des glossaires de terminologie, des aperçus de tables structurées et des mappages de données d'entreprise.
Pour en savoir plus sur l'utilisation des ensembles de contexte dans Google Cloud, consultez la présentation des ensembles de contexte pour Knowledge Studio, AlloyDB pour PostgreSQL, Cloud SQL pour MySQL, Cloud SQL pour PostgreSQL ou Spanner.
Pour créer et gérer des ensembles de contexte pour l'ancrage de l'IA, vous devez disposer des rôles IAM suivants :
- Lecteur de catalogue Dataplex (
roles/dataplex.catalogViewer) : accès en lecture seule pour afficher, lister et télécharger des ensembles de contexte, et pour afficher les emplacements. - Éditeur de catalogue Dataplex (
roles/dataplex.catalogEditor) : accès permettant de mettre à jour, de supprimer, d'importer et de télécharger des ensembles de contextes. - Administrateur de catalogue Dataplex (
roles/dataplex.catalogAdmin) ou Propriétaire du groupe d'entrées Dataplex (roles/dataplex.entryGroupOwner) : accès administratif complet aux ensembles de contextes, y compris l'autorisationdataplex.entryGroups.setIamPolicyrequise pour créer des ensembles de contextes.
Le tableau suivant liste les autorisations IAM requises pour utiliser des ensembles de contextes :
| Opération | Autorisation IAM |
|---|---|
| Créer des ensembles de contextes | dataplex.entryGroups.createContextSet |
| Supprimer des ensembles de contexte | dataplex.entryGroups.deleteContextSet |
| Lire les ensembles de contexte | dataplex.entryGroups.getContextSet |
| Mettre à jour les ensembles de contextes | dataplex.entryGroups.updateContextSet |
| Changements de contexte de la requête | dataplex.entryGroups.requestContextChanges |
| Créer des entrées de contexte | dataplex.entries.createContext |
| Supprimer les entrées de contexte | dataplex.entries.deleteContext |
| Lire les entrées de contexte | dataplex.entries.getContext |
| Lister les entrées de contexte | dataplex.entries.listContext |
| Mettre à jour les entrées de contexte | dataplex.entries.updateContext |
Pour en savoir plus, consultez Rôles IAM Knowledge Catalog.
Autorisations pour les jobs de métadonnées
Le tableau suivant répertorie les autorisations requises pour utiliser les jobs d'importation de métadonnées et les jobs d'exportation de métadonnées.
| Opération | Autorisation IAM |
|---|---|
| Accéder aux résultats exportés des jobs d'exportation de métadonnées |
|
Cancel metadata jobs |
|
Create metadata export jobs |
|
Create metadata import jobs |
|
Get metadata jobs |
|
List metadata jobs |
|
Types d'aspects, types d'entrées et types de liens d'entrée du système
Chaque type d'aspect, type d'entrée et type de lien d'entrée défini par le système dispose de ses propres autorisations IAM. Ces autorisations utilisent un format tel que dataplex.entryGroups.useASPECT_TYPE, dataplex.entryGroups.useENTRY_TYPE ou dataplex.entryGroups.useENTRY_LINK_TYPE. Par exemple, l'autorisation pour le type d'aspect système overview est dataplex.entryGroups.useOverviewAspect.
Le tableau suivant liste les autorisations qui s'appliquent aux types d'aspects, d'entrées et de liens d'entrée définis par le système.
| Ressource | Autorisation IAM |
|---|---|
contacts (type d'aspect système) |
dataplex.entryGroups.useContactsAspect |
data-profile (type d'aspect système) |
dataplex.entryGroups.useDataProfileAspect |
data-quality-rule-template (type d'aspect système) |
dataplex.entryGroups.useDataQualityRuleTemplateAspect |
data-quality-scorecard (type d'aspect système) |
dataplex.entryGroups.useDataQualityScorecardAspect |
data-rules (type d'aspect système) |
dataplex.entryGroups.useDataRulesAspect |
generic (type d'aspect système) |
dataplex.entryGroups.useGenericAspect |
guidelines (type d'aspect système) |
dataplex.entryGroups.useGuidelinesAspect |
overview (type d'aspect système) |
dataplex.entryGroups.useOverviewAspect |
schema (type d'aspect système) |
dataplex.entryGroups.useSchemaAspect |
schema-join (type d'aspect système) |
dataplex.entryGroups.useSchemaJoinAspect |
generic (type d'entrée système) |
dataplex.entryGroups.useGenericEntry |
definition (type de lien d'entrée système) |
dataplex.entryGroups.useDefinitionEntryLink |
related (type de lien d'entrée système) |
dataplex.entryGroups.useRelatedEntryLink |
synonym (type de lien d'entrée système) |
dataplex.entryGroups.useSynonymEntryLink |
schema-join (type de lien d'entrée système) |
dataplex.entryGroups.useSchemaJoinEntryLink |
Autorisations au niveau des lacs, des zones et des éléments
Le tableau suivant liste les autorisations requises pour utiliser des lacs, des zones et des éléments :
| Méthode API | Autorisation IAM |
|---|---|
CreateAsset |
dataplex.assets.create |
CreateLake |
dataplex.lakes.create |
CreateZone |
dataplex.zones.create |
DeleteAsset |
dataplex.assets.delete |
DeleteLake |
dataplex.lakes.delete |
DeleteZone |
dataplex.zones.delete |
GetAsset |
dataplex.assets.get |
GetLake |
dataplex.lakes.get |
GetZone |
dataplex.zones.get |
ListAssetActions |
dataplex.assetActions.list |
ListAssets |
dataplex.assets.list |
ListLakeActions |
dataplex.lakeActions.list |
ListLakes |
dataplex.lakes.list |
ListZoneActions |
dataplex.zoneActions.list |
ListZones |
dataplex.zones.list |
UpdateAsset |
dataplex.assets.update |
UpdateLake |
dataplex.lakes.update |
UpdateZone |
dataplex.zones.update |
Autorisations des tâches
Le tableau suivant recense les autorisations requises pour effectuer des opérations sur les tâches :
| Méthode API | Autorisation IAM |
|---|---|
CancelJob |
dataplex.tasks.cancel |
CreateTask |
dataplex.tasks.create |
DeleteTask |
dataplex.tasks.delete |
GetJob |
dataplex.tasks.get |
GetTask |
dataplex.tasks.get |
ListJobs |
dataplex.tasks.get |
ListTasks |
dataplex.tasks.list |
UpdateTask |
dataplex.tasks.update |
Autorisations de métadonnées
Le tableau suivant répertorie les autorisations requises pour effectuer des opérations sur les entités et les partitions :
| Méthode API | Autorisation IAM |
|---|---|
CreateEntity |
dataplex.entities.create |
CreatePartition |
dataplex.partitions.create |
DeleteEntity |
dataplex.entities.delete |
DeletePartition |
dataplex.partitions.delete |
GetEntity |
dataplex.entities.get |
GetPartition |
dataplex.partitions.get |
ListEntities |
dataplex.entities.list |
ListPartitions |
dataplex.partitions.list |
Autorisations d'analyse des données
Le tableau suivant liste les autorisations requises pour effectuer des opérations sur les analyses de données :
| Méthode API | Autorisation IAM |
|---|---|
CancelDataScanJob |
dataplex.datascans.cancel |
CreateDataScan |
dataplex.datascans.create |
DeleteDataScan |
dataplex.datascans.delete |
GetDataScan (vue de base) |
dataplex.datascans.get |
GetDataScan (vue complète) |
dataplex.datascans.getData |
GetDataScanJob (vue de base) |
dataplex.datascans.get |
GetDataScanJob (vue complète) |
dataplex.datascans.getData |
ListDataScanJobs |
dataplex.datascans.get |
ListDataScans |
dataplex.datascans.list |
RunDataScan |
dataplex.datascans.run |
UpdateDataScan |
dataplex.datascans.update |
Tâches d'enrichissement Knowledge Studio
Les autorisations suivantes sont requises pour créer et gérer des tâches d'enrichissement Knowledge Studio :
| Opération | Autorisation IAM |
|---|---|
| Créer des tâches d'enrichissement | dataplex.agentTasks.create |
| Supprimer des tâches d'enrichissement | dataplex.agentTasks.delete |
| Lire les détails de la tâche d'enrichissement | dataplex.agentTasks.get |
| Lire et récupérer les résultats des données sous-jacentes | dataplex.agentTasks.getData |
| Lister les tâches d'enrichissement | dataplex.agentTasks.list |
| Mettre à jour les tâches d'enrichissement | dataplex.agentTasks.update |
| Exécuter des tâches d'enrichissement | dataplex.agentTasks.run |
| Demander des modifications des groupes d'entrées (propositions) | dataplex.entryGroups.requestChanges |
| Approuver les demandes de modification des métadonnées | dataplex.changeRequests.use |
| Annuler les exécutions de tâches d'enrichissement | dataplex.agentTasks.cancel |
Autorisations des fournisseurs d'authentification tiers
Lors de la configuration de connecteurs externes, les autorisations d'identité d'agent suivantes sont requises pour gérer les fournisseurs d'authentification :
| Opération | Autorisation IAM |
|---|---|
| Créer des fournisseurs d'authentification | agentidentity.authProviders.create |
| Afficher les détails du fournisseur d'authentification | agentidentity.authProviders.get |
| Supprimer les fournisseurs d'authentification | agentidentity.authProviders.delete |
| Mettre à jour les fournisseurs d'authentification | agentidentity.authProviders.update |
Autorisations de profilage BigQuery
Pour permettre à l'agent d'enrichissement d'effectuer le profilage des données BigQuery et de lire l'historique des requêtes de table, vous devez attribuer les rôles Lecteur de données BigQuery (roles/bigquery.dataViewer) et Lecteur de ressources BigQuery (roles/bigquery.resourceViewer) à l'agent de service Knowledge Catalog (service-<var>PROJECT_NUMBER</var>@gcp-sa-dataplex.iam.gserviceaccount.com) du projet cible.