Mapper les autorisations IAM entre Data Catalog et Knowledge Catalog

Lorsque vous passez de Data Catalog à Knowledge Catalog (anciennement Dataplex Universal Catalog), vous devez mettre à jour vos règles Identity and Access Management (IAM) pour garantir un accès cohérent. Ce document compare en détail les autorisations Data Catalog héritées et leurs autorisations équivalentes dans Knowledge Catalog. Utilisez ces mappages pour auditer vos rôles existants ou pour créer des rôles personnalisés pour la gestion des métadonnées.

Pour en savoir plus, consultez Autorisations Data Catalog et Autorisations Knowledge Catalog.

Groupes d'entrées

Le tableau suivant fournit un mappage détaillé entre les autorisations Data Catalog et les autorisations Knowledge Catalog pour les opérations courantes sur les groupes d'entrées :

Opération Autorisations requises dans Data Catalog Autorisations requises dans Knowledge Catalog
Créer des groupes d'entrée datacatalog.entryGroups.create dataplex.entryGroups.create
Mettre à jour les groupes d'entrées datacatalog.entryGroups.update dataplex.entryGroups.update
Afficher les détails d'un groupe d'entrées datacatalog.entryGroups.get dataplex.entryGroups.get
Supprimer des groupes d'entrées datacatalog.entryGroups.delete dataplex.entryGroups.delete

Pour en savoir plus sur les groupes d'entrées, consultez Groupes d'entrées dans Data Catalog et Groupes d'entrées dans Knowledge Catalog.

Entrées

Le tableau suivant fournit un mappage détaillé entre les autorisations Data Catalog et les autorisations Knowledge Catalog pour les opérations courantes sur les entrées :

Opération Autorisations requises dans Data Catalog Autorisations requises dans Knowledge Catalog Remarques
Créer des entrées personnalisées datacatalog.entries.create

dataplex.entries.create

dataplex.entryTypes.use (pour utiliser le type d'entrée afin de créer des entrées de ce type)

dataplex.aspectTypes.use (pour utiliser les types d'aspect afin de créer des entrées avec les aspects correspondants)

Data Catalog ne comporte pas de notion de types d'entrées.

Dans Data Catalog, vous ne pouvez créer des tags pour une entrée qu'une fois celle-ci créée. Dans Knowledge Catalog, vous pouvez créer des aspects pour une entrée lorsque vous la créez.

Utiliser des types d'entrées système réutilisables pour créer des entrées Non applicable Autorisation spécifiée sur le groupe d'entrées (par exemple, dataplex.entryGroups.useENTRY_TYPE) Pour en savoir plus, consultez Types d'aspects, d'entrées et de liens d'entrées système.
Afficher les détails d'une entrée personnalisée datacatalog.entries.get dataplex.entries.get -
Afficher les détails d'une entrée système Autorisation spécifique au système, par exemple bigquery.tables.get

dataplex.entries.get (pour la méthode entries.get)
ou
autorisation spécifique au système (par exemple, bigquery.tables.get (pour la méthode lookupEntry))

Dans Knowledge Catalog, vous pouvez récupérer une entrée à l'aide de la méthode entries.get ou lookupEntry. La différence entre ces méthodes réside dans les autorisations requises.

La console Google Cloud utilise la méthode lookupEntry.

Lister les entrées datacatalog.entries.list (pour les entrées personnalisées) dataplex.entries.list (pour les entrées système et personnalisées)

Data Catalog n'est pas compatible avec l'affichage des entrées système.

Dans Knowledge Catalog, les groupes d'entrées système sont des ressources valides sur lesquelles vous pouvez définir des autorisations.

Effectuer une recherche Aucune autorisation n'est requise pour l'action de recherche elle-même. dataplex.projects.search

Dans Data Catalog, vous pouvez effectuer la recherche sans avoir besoin d'autorisations spéciales.

Pour effectuer une recherche dans Knowledge Catalog, vous devez disposer de l'autorisation dataplex.projects.search sur le projet utilisé pour la recherche. Ce projet est défini à l'aide du name paramètre dans la searchEntries searchEntries, tandis que le paramètre scope définit les projets dans lesquels vous effectuez la recherche.

Dans Data Catalog et Knowledge Catalog, les résultats de recherche sont soumis à des vérifications des autorisations spécifiques au système. Vous ne voyez que les ressources auxquelles vous êtes autorisé à accéder.

Pour en savoir plus sur les autorisations requises pour rechercher des entrées dans Knowledge Catalog, consultez Entrées.

Modifier les champs (autres que les tags et les aspects) dans les entrées personnalisées datacatalog.entries.update

dataplex.entries.update

dataplex.entryTypes.use

L'autorisation entryTypes.use dans Knowledge Catalog protège les champs non liés aux aspects, tels que entrySource. Par exemple, vous pouvez utiliser cette autorisation pour empêcher vos utilisateurs de modifier les champs définis par un pipeline de connectivité géré.
Définir des autorisations pour une entrée spécifique au lieu d'un groupe d'entrées

Généralement non pris en charge.

Toutefois, vous pouvez définir une autorisation sur une entrée spécifique lorsque vous mettez à jour les tags d'une entrée système. Pour ce faire, vous devez disposer d'autorisations sur le système source.

Non compatible

Les règles IAM ne sont créées que pour les groupes d'entrées.

Dans Data Catalog, lorsque vous mettez à jour les tags d'une entrée système, vous avez besoin d'autorisations sur le système source. Par exemple, lorsque vous mettez à jour les tags d'une table BigQuery, vous avez besoin de l'autorisation bigquery.tables.updateTag. Vous pouvez définir cette autorisation pour une entrée spécifique.

Dans Knowledge Catalog, pour mettre à jour les aspects d'une entrée, vous avez besoin de dataplex.entries.update, qui ne peut pas être défini sur une entrée spécifique.

Supprimer les entrées datacatalog.entries.delete dataplex.entries.delete -

Pour en savoir plus sur les entrées, consultez Entrées dans Data Catalog et Entrées dans Knowledge Catalog.

Modèles de tags et types d'aspects

Le tableau suivant fournit un mappage détaillé entre les autorisations Data Catalog et les autorisations Knowledge Catalog pour les opérations courantes sur les modèles de tags (dans Data Catalog) et les types d'aspects (dans Knowledge Catalog).

Opération Autorisations requises dans Data Catalog Autorisations requises dans Knowledge Catalog Remarques
Créer des modèles de tags ou des types d'aspects datacatalog.tagTemplates.create dataplex.aspectTypes.create -
Mettre à jour des modèles de tags ou des types d'aspects datacatalog.tagTemplates.update dataplex.aspectTypes.update -
Afficher les détails d'un modèle de tag ou d'un type d'aspect datacatalog.tagTemplates.get dataplex.aspectTypes.get -
Lister tous les modèles de tags ou types d'aspects Non compatible dataplex.aspectTypes.list Data Catalog n'est pas compatible avec la liste des modèles de tags.
Utiliser des types d'aspect système réutilisables Non applicable Autorisation spécifiée sur le groupe d'entrées au lieu de dataplex.aspectTypes.use. Exemple : dataplex.entryGroups.useASPECT_TYPE. Pour en savoir plus, consultez Types d'aspects, d'entrées et de liens d'entrées système.
Supprimer des modèles de tags ou des types d'aspects datacatalog.tagTemplates.delete dataplex.aspectTypes.delete -

Tags et aspects

Le tableau suivant fournit un mappage détaillé entre les autorisations Data Catalog et les autorisations Knowledge Catalog pour les opérations courantes sur les tags (dans Data Catalog) et les aspects (dans Knowledge Catalog).

Opération Autorisations requises dans Data Catalog Autorisations requises dans Knowledge Catalog Remarques
Créer, modifier et supprimer des tags ou des aspects

datacatalog.entries.updateTag
ou l'équivalent dépendant du service, par exemple
bigquery.tables.updateTag

datacatalog.tagTemplates.use

dataplex.entries.update

dataplex.aspectTypes.use

Dans Data Catalog, les tags sont des ressources autonomes par rapport aux entrées. Vous mettez à jour les tags et les entrées à l'aide de méthodes distinctes, et les autorisations requises sont également distinctes.

Dans Knowledge Catalog, les aspects sont stockés dans des entrées, et non en tant que ressources autonomes. Pour mettre à jour les aspects d'une entrée, vous devez mettre à jour l'entrée. Cela s'applique aux entrées système et personnalisées.

Lister les tags ou les aspects

datacatalog.entries.get (pour les tags publics et privés)

datacatalog.tagTemplates.get (pour chaque tag privé. Si vous n'avez pas accès à un tag, il est omis des résultats de recherche.)

dataplex.entries.get Dans Knowledge Catalog, lorsque vous récupérez une entrée, ses aspects sont également listés.

Étape suivante