Gérer les produits de données

Preview

Ce produit ou cette fonctionnalité sont soumis aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités de pré-DG sont proposés "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Ce document s'adresse aux propriétaires de produits de données qui souhaitent mettre à jour ou supprimer des produits de données dans Dataplex Universal Catalog, ou accorder l'accès à ces produits.

Pour en savoir plus sur l'architecture et les concepts clés des produits de données, consultez À propos des produits de données.

Avant de commencer

1. Enable the Dataplex, BigQuery APIs.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the APIs

Remarque : Ce guide suppose que vous disposez déjà de produits de données à gérer. Pour en savoir plus sur la création et la configuration de produits de données, consultez Créer des produits de données.

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les produits de données, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :

• Autorisations complètes pour créer, modifier, supprimer et gérer les autorisations pour les produits de données : Administrateur des produits de données Dataplex (roles/dataplex.dataProductAdmin)
• Mettre à jour et gérer les produits de données existants : Éditeur de produits de données Dataplex (roles/dataplex.dataProductEditor)
• Ajouter des aspects tels que schema, overview et contacts : Propriétaire des entrées et des liens d'entrée Dataplex (roles/dataplex.entryOwner)
• Rechercher et ajouter des composants : Lecteur de catalogue Dataplex (roles/dataplex.catalogViewer)
• Modifier les types d'aspects système tels que la documentation et l'aspect contractuel de la fréquence d'actualisation : Éditeur de catalogue Dataplex (roles/dataplex.catalogEditor)

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 gérer les produits de données. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour gérer les produits de données :

• Modifiez le type d'aspect système overview : dataplex.entryGroups.useOverviewAspect
• Modifiez le type d'aspect système refresh cadence : dataplex.entryGroups.useRefreshCadenceAspect

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

Accorder l'accès à un produit de données

Les propriétaires de produits de données doivent rendre leurs produits détectables et accorder les rôles nécessaires, ce qui permet aux consommateurs de rechercher, d'afficher et de demander l'accès aux produits de données.

Pour accorder aux consommateurs de produits de données les autorisations dont ils ont besoin pour interagir avec le produit de données, accordez-leur les rôles IAM suivants sur la ressource du produit de données :

• Recherchez des produits de données et accédez-y dans la recherche Dataplex Universal Catalog : Consommateur de produits de données Dataplex (dataplex.dataProductsConsumer)
• Accès en lecture seule pour afficher les définitions et les métadonnées des produits de données : lecteur de produits de données Dataplex (dataplex.dataProductViewer)
• Demander l'accès aux produits de données : consommateur de produits de données Dataplex (dataplex.dataProductsConsumer)

Lorsqu'un consommateur de produit de données demande l'accès à un produit de données, le propriétaire du produit de données reçoit une notification par e-mail.

Pour accorder l'accès :

1. Dans la console Google Cloud , accédez à la page Groupes.

   Accéder à la page Groupes

2. Recherchez le groupe associé au niveau d'autorisation demandé, puis sélectionnez-le.

3. Cliquez sur  Ajouter des membres.

4. Ajoutez le compte principal.

5. Cliquez sur Enregistrer.

Pour en savoir plus, consultez Créer et gérer des groupes Google dans la console Google Cloud .

Mettre à jour un produit de données

Vous pouvez modifier les informations de base (par exemple, le nom du produit de données, la description, les informations sur le propriétaire), les composants, les groupes d'accès, les autorisations, le contrat, les aspects et la documentation supplémentaire d'un produit de données existant.

Modifier les informations de base d'un produit de données

Console

1. Dans la console Google Cloud , accédez à la page Produits de données de Dataplex Universal Catalog.

   Accéder à la page "Produits de données"

2. Cliquez sur le produit de données que vous souhaitez modifier.

3. Cliquez sur Modifier le produit de données.

4. Mettez à jour le nom du produit de données, l'icône, la description, les contacts du propriétaire et les libellés si nécessaire.

5. Cliquez sur Mettre à jour le produit de données.

REST

Pour mettre à jour les informations de base d'un produit de données, utilisez la méthode dataProducts.patch.

Par exemple, pour mettre à jour la description d'un produit de données, envoyez la requête PATCH suivante :

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{"description": "NEW_DESCRIPTION"}' \
https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/dataProducts/DATA_PRODUCT_ID?update_mask="description"

Remplacez les éléments suivants :

• NEW_DESCRIPTION : nouvelle description du produit de données
• PROJECT_ID : ID de votre projet Google Cloud
• LOCATION : région où existe le produit de données
• DATA_PRODUCT_ID : ID de votre produit de données

Mettre à jour les composants d'un produit de données

Console

1. Dans la console Google Cloud , accédez à la page Produits de données de Dataplex Universal Catalog.

   Accéder à la page "Produits de données"

2. Cliquez sur le produit de données pour lequel vous souhaitez modifier les composants.

3. Cliquez sur l'onglet Composants.

4. Pour ajouter un composant, procédez comme suit :

   1. Cliquez sur +Ajouter.

   2. Recherchez et sélectionnez les composants que vous souhaitez ajouter à votre produit de données. Les composants que vous sélectionnez doivent se trouver dans la même région que le produit de données.

      Si vous disposez des autorisations nécessaires, vous pouvez afficher les métadonnées des composants en cliquant dessus.

   3. Pour affiner les résultats de recherche, utilisez Filtres.

   4. Après avoir sélectionné les composants, cliquez sur Ajouter.

5. Pour supprimer un composant du produit de données, procédez comme suit :

   1. Pour le composant que vous souhaitez supprimer, cliquez sur > Supprimer.

   2. Pour confirmer l'action, cliquez sur Supprimer.

REST

Pour ajouter un élément de données au produit de données, utilisez la méthode dataAssets.create. Pour obtenir un exemple de code, consultez Facultatif : Ajouter des composants.

Pour supprimer un composant de données du produit de données, utilisez la méthode dataAssets.delete. Par exemple, envoyez la requête DELETE suivante :

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID/dataAssets/DATA_ASSET_ID"

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud
• LOCATION : région dans laquelle vous souhaitez créer le produit de données
• DATA_PRODUCT_ID : ID unique de votre produit de données
• DATA_ASSET_ID : ID de l'élément de données que vous souhaitez supprimer du produit de données

Modifier les groupes d'accès et les autorisations associées aux composants

Console

1. Dans la console Google Cloud , accédez à la page Produits de données de Dataplex Universal Catalog.

   Accéder à la page "Produits de données"

2. Cliquez sur le produit de données pour lequel vous souhaitez mettre à jour les groupes d'accès et les autorisations.

3. Cliquez sur l'onglet Groupes et autorisations d'accès.

4. Pour modifier un groupe d'accès, procédez comme suit :

   1. Cliquez sur Modifier.

   2. Modifiez le nom, la description et l'identifiant du groupe d'accès si nécessaire.

   3. Pour ajouter un groupe d'accès, cliquez sur Ajouter un groupe d'accès, puis procédez comme suit :

      1. Dans le champ Nom du groupe d'accès, saisissez le nom du nouveau groupe d'accès. Exemple :Analyst

      2. Dans le champ Description du groupe d'accès, saisissez une description du groupe d'accès.

      3. Dans le champ Identifiant du groupe d'accès, saisissez l'adresse e-mail d'un groupe Google que vous souhaitez attribuer à ce groupe d'accès. Les consommateurs de produits de données qui demandent l'accès à ce groupe d'accès peuvent être ajoutés en tant que membres au groupe Google mappé.

         Vous pouvez ajouter jusqu'à trois groupes d'accès par produit de données.

   4. Cliquez sur Ajouter.

5. Pour supprimer un groupe d'accès :

   1. Pour le groupe d'accès que vous souhaitez supprimer, cliquez sur > Supprimer.

   2. Pour confirmer l'action, cliquez sur Supprimer.

6. Si aucun groupe d'accès n'est configuré pour le produit de données sélectionné, vous pouvez en ajouter un en cliquant sur Ajouter un groupe d'accès.

7. Pour mettre à jour les autorisations d'un composant, procédez comme suit :

   1. Pour l'élément dont vous souhaitez modifier les autorisations, cliquez sur > Autorisations.

   2. Mettez à jour les groupes d'accès et les rôles IAM requis.

   3. Cliquez sur Configurer.

REST

Pour mettre à jour les groupes d'accès associés à un produit de données, utilisez la méthode dataProducts.patch. Pour obtenir un exemple de code, consultez Configurer des groupes d'accès.

Pour mettre à jour les autorisations d'un élément, utilisez la méthode dataAssets.patch. Pour obtenir un exemple de code, consultez Configurer les autorisations des composants.

Mettre à jour le contrat du produit de données

Remarque : Vous ne pouvez pas modifier la fréquence d'actualisation après l'avoir ajoutée au contrat. Si vous essayez de modifier cette valeur, l'erreur suivante s'affiche : You don't have permission to change contract values.

Console

1. Dans la console Google Cloud , accédez à la page Produits de données de Dataplex Universal Catalog.

   Accéder à la page "Produits de données"

2. Cliquez sur le produit de données pour lequel vous souhaitez modifier le contrat.

3. Cliquez sur l'onglet Contrat.

4. Pour modifier le contrat existant, procédez comme suit :

   1. Cliquez sur Modifier.

   2. Mettez à jour les champs nécessaires.

   3. Cliquez sur Enregistrer.

5. Si aucun contrat n'est associé au produit de données sélectionné, vous pouvez en ajouter un en cliquant sur Ajouter un contrat.

REST

Pour mettre à jour un contrat, utilisez la méthode entries.patch. Pour obtenir un exemple de code, consultez Ajouter un contrat.

Mettre à jour des aspects d'un produit de données

Console

1. Dans la console Google Cloud , accédez à la page Produits de données de Dataplex Universal Catalog.

   Accéder à la page "Produits de données"

2. Cliquez sur le produit de données pour lequel vous souhaitez mettre à jour les aspects.

3. Cliquez sur l'onglet Aspects.

4. Pour modifier un aspect, procédez comme suit :

   1. Cliquez sur l'aspect que vous souhaitez modifier.

   2. Cliquez sur Modifier.

   3. Modifiez Type d'aspect, Pays et Région si nécessaire.

   4. Cliquez sur Enregistrer.

5. Pour ajouter un aspect au produit de données, procédez comme suit :

   1. Cliquez sur + Ajouter un aspect.

   2. Dans le champ Sélectionner un type d'aspect, recherchez et sélectionnez un type d'aspect dans la liste. Exemple :Geo context

   3. Dans le champ Pays, sélectionnez le pays auquel appartient l'élément.

   4. Dans le champ Région, sélectionnez la région commerciale à laquelle appartient le composant.

   5. Cliquez sur Enregistrer.

6. Pour supprimer un aspect, procédez comme suit :

   1. Cliquez sur l'aspect que vous souhaitez supprimer.

   2. Cliquez sur .

   3. Pour confirmer l'action, cliquez sur Confirmer.

REST

Pour mettre à jour un aspect de l'entrée du produit de données, utilisez la méthode entries.patch.

Mettre à jour la documentation du produit de données

Console

1. Dans la console Google Cloud , accédez à la page Produits de données de Dataplex Universal Catalog.

   Accéder à la page "Produits de données"

2. Cliquez sur le produit de données pour lequel vous souhaitez mettre à jour la documentation.

3. Cliquez sur l'onglet Vue d'ensemble.

4. Cliquez sur Modifier à côté de Documentation.

5. Mettez à jour le guide de l'utilisateur, les exemples de requêtes et les autres documents selon les besoins.

6. Cliquez sur Enregistrer.

REST

La documentation fait partie de l'aspect overview. Pour mettre à jour la documentation sur le produit de données, utilisez la méthode entries.patch.

Supprimer un produit de données

Pour supprimer un produit de données, vous devez d'abord supprimer tous les composants du produit de données.

Console

1. Dans la console Google Cloud , accédez à la page Produits de données de Dataplex Universal Catalog.

   Accéder à la page "Produits de données"

2. Cliquez sur le produit de données que vous souhaitez supprimer.

3. Cliquez sur l'onglet Composants.

4. Pour chaque composant listé, cliquez sur > Supprimer. Confirmez l'opération en cliquant sur Supprimer.

5. Après avoir supprimé tous les composants, supprimez le produit de données en cliquant sur Supprimer.

6. Dans la boîte de dialogue de confirmation, saisissez delete, puis cliquez sur Supprimer.

REST

Pour supprimer un produit de données, utilisez la méthode dataProducts.delete.

Par exemple, envoyez la requête DELETE suivante :

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/dataProducts/DATA_PRODUCT_ID

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud
• LOCATION : région où existe le produit de données
• DATA_PRODUCT_ID : ID du produit de données que vous souhaitez supprimer

Étapes suivantes

• Découvrez comment rechercher des produits de données.
• Découvrez comment demander l'accès aux produits de données.