Demander des modifications de métadonnées avec des workflows de gouvernance

Ce document explique comment proposer des modifications de ressources uniques aux catégories et termes du glossaire d'entreprise, ainsi qu'aux entrées Knowledge Catalog (anciennement Dataplex Universal Catalog), à l'aide de workflows de gouvernance.

Avant de commencer

Pour utiliser des workflows de gouvernance pour les modifications de métadonnées, assurez-vous d'avoir activé les API requises et de disposer des rôles et autorisations IAM (Identity and Access Management) nécessaires.

Activez l'API Dataplex, si ce n'est pas déjà fait.

Rôles requis pour activer les API

Pour activer des API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez l'obtenir via le rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.

Activer l'API

Rôles requis

Pour obtenir les autorisations nécessaires pour demander des modifications de métadonnées, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet, votre glossaire ou votre groupe d'entrées :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

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

Pour en savoir plus sur les rôles et les autorisations, consultez Rôles IAM Knowledge Catalog.

Demander des modifications pour une catégorie de glossaire

Si vous ne disposez pas d'un accès en écriture direct pour créer, mettre à jour ou supprimer une catégorie de glossaire, vous pouvez demander une telle modification à l'aide de workflows de gouvernance. Une fois qu'une demande de modification de métadonnées est envoyée, les demandeurs, les approbateurs et les administrateurs de workflow peuvent surveiller et gérer la demande tout au long de son cycle de vie.

Créer une catégorie

Console

Pour demander une catégorie, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Glossaires de Knowledge Catalog.

    Accéder à Glossaires

  2. Sélectionnez le glossaire dans lequel vous souhaitez créer une catégorie, puis cliquez sur Créer une catégorie.

  3. Saisissez un nom à afficher pour la catégorie.

  4. Facultatif : dans la section Libellés, ajoutez des libellés pour le glossaire.

  5. Facultatif : dans la section Justification, indiquez à l'approbateur la raison de votre modification.

  6. Dans la section Paramètres avancés, vous pouvez modifier l'ID de catégorie si vous souhaitez modifier l'ID généré automatiquement.

  7. Cliquez sur Envoyer pour examen.

Le système enregistre une nouvelle demande de modification et en informe l'approbateur. Vous pouvez suivre la progression de la demande sur la page Workflows de gouvernance, sous l'onglet Mes demandes.

REST

Pour demander la création d'une catégorie, utilisez la méthode glossaries.requestGlossaryChange :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createCategoryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "categoryId": "sample-category-id",
      "category": {
        "displayName": "Sample category name",
        "description": "Sample category description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • LOCATION : région où se trouve le glossaire, par exemple us-central1.
  • GLOSSARY_ID : ID du glossaire parent.
  • JUSTIFICATION : explication de la raison pour laquelle vous proposez la modification.

Le service renvoie une réponse contenant le nom de ressource de la demande de modification. Le système enregistre une nouvelle demande de modification et en informe l'approbateur.

Modifier une catégorie

Console

Pour suggérer des modifications à une catégorie :

  1. Dans la console Google Cloud , accédez à la page Glossaires de Knowledge Catalog.

    Accéder à Glossaires

  2. Sélectionnez le glossaire qui inclut la catégorie que vous souhaitez modifier.

  3. Cliquez sur le nom de la catégorie pour ouvrir le volet Détails de la catégorie.

  4. Pour ajouter ou modifier des informations sur une catégorie, cliquez sur  Ajouter ou  Modifier à côté de la section que vous souhaitez modifier.

  5. Cliquez sur Envoyer pour examen. Certains éléments peuvent nécessiter une justification supplémentaire pour la modification. Indiquez la justification, puis cliquez sur Envoyer les modifications.

Le système enregistre une nouvelle demande de modification et en informe l'approbateur. Vous pouvez suivre la progression de la demande sur la page Workflows de gouvernance, sous l'onglet Mes demandes.

REST

Pour demander la mise à jour du nom à afficher et de la description d'une catégorie, utilisez la méthode glossaries.requestGlossaryChange :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateCategoryRequest": {
      "category": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • LOCATION : région où se trouve le glossaire, par exemple us-central1.
  • GLOSSARY_ID : ID du glossaire parent.
  • CATEGORY_ID : ID de la catégorie cible que vous souhaitez mettre à jour.
  • JUSTIFICATION : explication de la raison pour laquelle vous proposez la modification.

Le service renvoie une réponse contenant le nom de ressource de la demande de modification. Le système enregistre une nouvelle demande de modification et en informe l'approbateur.

Supprimer une catégorie

Console

Pour demander la suppression d'une catégorie, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Glossaires de Knowledge Catalog.

    Accéder à Glossaires

  2. Développez le glossaire, puis cliquez sur la catégorie que vous souhaitez supprimer.

  3. Dans le volet Détails de la catégorie, sélectionnez  Supprimer dans le menu.

  4. Facultatif : dans la section Justification, indiquez à l'approbateur la raison de votre modification.

  5. Cliquez sur Envoyer pour examen.

Le système enregistre une nouvelle demande de modification et en informe l'approbateur. Vous pouvez suivre la progression de la demande sur la page Workflows de gouvernance, sous l'onglet Mes demandes.

REST

Pour demander la suppression d'une catégorie, utilisez la méthode glossaries.requestGlossaryChange :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteCategoryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • LOCATION : région où se trouve le glossaire, par exemple us-central1.
  • GLOSSARY_ID : ID du glossaire parent.
  • CATEGORY_ID : ID de la catégorie cible que vous souhaitez supprimer.
  • JUSTIFICATION : explication de la raison pour laquelle vous proposez la modification.

Le service renvoie une réponse contenant le nom de ressource de la demande de modification. Le système enregistre une nouvelle demande de modification et en informe l'approbateur.

Demander des modifications pour un terme du glossaire

Si vous ne disposez pas d'un accès en écriture direct pour créer, mettre à jour ou supprimer un terme du glossaire, vous pouvez demander une telle modification à l'aide des workflows de gouvernance.

Créer un terme de glossaire

Console

Pour demander la création d'un terme de glossaire, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Glossaires de Knowledge Catalog.

    Accéder à Glossaires

  2. Sélectionnez le glossaire ou la catégorie dans lequel vous souhaitez créer un terme pour ouvrir le volet "Détails".

    • Si vous créez un terme à partir de la page d'informations du glossaire, sélectionnez Créer un terme dans le menu.
    • Si vous créez un terme à partir de la page d'informations de la catégorie, sélectionnez Ajouter un terme dans le menu.

  3. Saisissez un nom à afficher pour la catégorie.

  4. (Facultatif) Dans la section Libellés, ajoutez des libellés pour le terme.

  5. Facultatif : dans la section Justification, indiquez à l'approbateur la raison de votre modification.

  6. Dans la section Paramètres avancés, vous pouvez modifier l'ID du terme si vous souhaitez modifier l'ID généré automatiquement.

  7. Cliquez sur Envoyer pour examen.

Le système enregistre une nouvelle demande de modification et en informe l'approbateur. Vous pouvez suivre la progression de la demande sur la page Workflows de gouvernance, sous l'onglet Mes demandes.

REST

Pour demander la création d'un terme de glossaire, utilisez la méthode glossaries.requestGlossaryChange :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createTermRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "termId": "sample-term-id",
      "term": {
        "displayName": "Sample term name",
        "description": "Sample term description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • LOCATION : région où se trouve le glossaire, par exemple us-central1.
  • GLOSSARY_ID : ID du glossaire parent.
  • JUSTIFICATION : explication de la raison pour laquelle vous proposez la modification.

Le service renvoie une réponse contenant le nom de ressource de la demande de modification. Le système enregistre une nouvelle demande de modification et en informe l'approbateur.

Mettre à jour un terme de glossaire

Console

Pour demander des modifications d'un terme du glossaire, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Glossaires de Knowledge Catalog.

    Accéder à Glossaires

  2. Sélectionnez le glossaire qui inclut le terme que vous souhaitez modifier.

  3. Cliquez sur le nom du terme pour ouvrir le volet Détails du terme.

  4. Ajoutez ou modifiez les détails des conditions en cliquant sur  Ajouter ou  Modifier à côté de la section que vous souhaitez modifier.

  5. Cliquez sur Envoyer pour examen. Certaines sections peuvent vous demander de fournir une justification supplémentaire avant de pouvoir envoyer la demande. Indiquez la justification, puis cliquez sur Envoyer les modifications.

Le système enregistre une nouvelle demande de modification et en informe l'approbateur. Vous pouvez suivre la progression de la demande sur la page Workflows de gouvernance, sous l'onglet Mes demandes.

REST

Pour demander la mise à jour du nom à afficher et de la description d'un terme de glossaire, utilisez la méthode glossaries.requestGlossaryChange :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateTermRequest": {
      "term": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • LOCATION : région où se trouve le glossaire, par exemple us-central1.
  • GLOSSARY_ID : ID du glossaire parent.
  • TERM_ID : ID du terme cible que vous souhaitez mettre à jour.
  • JUSTIFICATION : explication de la raison pour laquelle vous proposez la modification.

Le service renvoie une réponse contenant le nom de ressource de la demande de modification. Le système enregistre une nouvelle demande de modification et en informe l'approbateur.

Supprimer un terme de glossaire

Console

Pour demander la suppression d'un terme, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Glossaires de Knowledge Catalog.

    Accéder à Glossaires

  2. Sélectionnez le glossaire qui inclut le terme que vous souhaitez supprimer.

  3. Cliquez sur le nom du terme pour ouvrir le volet Détails du terme.

  4. Cliquez sur Supprimer.

  5. Cliquez sur Envoyer pour examen. Certaines sections peuvent vous demander de fournir une justification supplémentaire avant de pouvoir envoyer la demande. Indiquez la justification, puis cliquez sur Envoyer les modifications.

Le système enregistre une nouvelle demande de modification et en informe l'approbateur. Vous pouvez suivre la progression de la demande sur la page Workflows de gouvernance, sous l'onglet Mes demandes.

REST

Pour demander la suppression d'un terme de glossaire, utilisez la méthode glossaries.requestGlossaryChange :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteTermRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • LOCATION : région où se trouve le glossaire, par exemple us-central1.
  • GLOSSARY_ID : ID du glossaire parent.
  • TERM_ID : ID du terme cible que vous souhaitez supprimer.
  • JUSTIFICATION : explication de la raison pour laquelle vous proposez la modification.

Le service renvoie un RequestGlossaryChangeResponse contenant le nom de ressource de la ChangeRequest.Le système consigne une nouvelle demande de modification et en informe l'approbateur.

Demander des modifications pour une entrée

Si vous ne disposez pas d'un accès en écriture direct pour créer, modifier ou supprimer une entrée Knowledge Catalog, vous pouvez demander une telle modification à l'aide de workflows de gouvernance.

Créer une entrée

Console

Pour demander la création d'une entrée, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Types de métadonnées de Knowledge Catalog.

    Accéder à "Types de métadonnées"

  2. Cliquez sur l'onglet Groupes d'entrées.

  3. Sélectionnez le groupe d'entrées dans lequel vous souhaitez créer une entrée, puis cliquez sur Créer une entrée.

  4. Saisissez un ID et un nom à afficher pour l'entrée.

  5. Sélectionnez un type d'entrée.

  6. Facultatif : fournissez des détails sur l'aspect ou ajoutez une description.

  7. Cliquez sur Envoyer pour examen. Certaines sections peuvent vous demander de fournir une justification supplémentaire avant de pouvoir envoyer la demande. Indiquez la justification, puis cliquez sur Envoyer les modifications.

Le système enregistre une nouvelle demande de modification et en informe l'approbateur. Vous pouvez suivre la progression de la demande sur la page Workflows de gouvernance, sous l'onglet Mes demandes.

REST

Pour demander la création d'une entrée, utilisez la méthode entryGroups.requestCatalogChange :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryId": "sample-entry-id",
      "entry": {
        "entryType": "projects/PROJECT_ID/locations/LOCATION/entryTypes/ENTRY_TYPE_ID",
        "entrySource": {
          "displayName": "Sample entry name",
          "description": "Sample entry description"
        }
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • LOCATION : région dans laquelle se trouve le groupe d'entrées, par exemple us-central1.
  • ENTRY_GROUP_ID : ID du groupe d'entrées parent.
  • ENTRY_TYPE_ID : ID du type d'entrée.
  • JUSTIFICATION : explication de la raison pour laquelle vous proposez la modification.

Le service renvoie une réponse contenant le nom de ressource de la demande de modification. Le système consigne une nouvelle demande de modification et en informe l'approbateur.

Mettre à jour une entrée

Console

Pour demander la mise à jour d'une entrée, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Rechercher ou Catalogue de Knowledge Catalog.

Accéder à la recherche

  1. Recherchez et sélectionnez l'entrée que vous souhaitez mettre à jour.
  2. Cliquez sur l'entrée pour ouvrir la page Détails de l'entrée.
  3. Cliquez sur Ajouter à côté de la section que vous souhaitez modifier.
  4. Mettez à jour la section.
  5. Cliquez sur Envoyer pour examen. Certaines sections peuvent vous demander de fournir une justification supplémentaire avant de pouvoir envoyer la demande. Indiquez la justification, puis cliquez sur Envoyer les modifications.

Le système enregistre une nouvelle demande de modification et en informe l'approbateur. Vous pouvez suivre la progression de la demande sur la page Workflows de gouvernance, sous l'onglet Mes demandes.

REST

Pour demander la mise à jour du nom à afficher et de la description d'une source d'entrée, utilisez la méthode entryGroups.requestCatalogChange :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "entrySource": {
          "displayName": "Sample new name",
          "description": "Sample new description"
        }
      },
      "updateMask": {
        "paths": [
          "entry_source.display_name",
          "entry_source.description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • LOCATION : région dans laquelle se trouve le groupe d'entrées, par exemple us-central1.
  • ENTRY_GROUP_ID : ID du groupe d'entrées parent.
  • ENTRY_ID : ID de l'entrée cible.
  • JUSTIFICATION : explication de la raison pour laquelle vous proposez la modification.

Le service renvoie une réponse contenant le nom de ressource de la demande de modification. Le système consigne une nouvelle demande de modification et en informe l'approbateur.

Supprimer une entrée

Console

Pour demander la suppression d'une entrée, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Rechercher ou Catalogue de Knowledge Catalog.

Accéder à la recherche

  1. Recherchez et sélectionnez l'entrée que vous souhaitez supprimer.
  2. Cliquez sur l'entrée pour ouvrir la page Détails de l'entrée.
  3. Cliquez sur Supprimer.
  4. Cliquez sur Envoyer pour examen. Certaines sections peuvent vous demander de fournir une justification supplémentaire avant de pouvoir envoyer la demande. Indiquez la justification, puis cliquez sur Envoyer les modifications.

Le système enregistre une nouvelle demande de modification et en informe l'approbateur. Vous pouvez suivre la progression de la demande sur la page Workflows de gouvernance, sous l'onglet Mes demandes.

REST

Pour demander la suppression d'une entrée, utilisez la méthode entryGroups.requestCatalogChange :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • LOCATION : région dans laquelle se trouve le groupe d'entrées, par exemple us-central1.
  • ENTRY_GROUP_ID : ID du groupe d'entrées parent.
  • ENTRY_ID : ID de l'entrée cible que vous souhaitez supprimer.
  • JUSTIFICATION : explication de la raison pour laquelle vous proposez la modification.

Le service renvoie une réponse contenant le nom de ressource de la demande de modification. Le système consigne une nouvelle demande de modification et en informe l'approbateur.

Mettre à jour un aspect

Console

Pour demander la mise à jour d'un aspect, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Rechercher de Knowledge Catalog.

Accéder à la recherche

  1. Recherchez et sélectionnez l'entrée pour laquelle vous souhaitez demander la modification.
  2. Cliquez sur l'entrée pour ouvrir la page Détails de l'entrée.
  3. Accédez à la section Aspects, puis cliquez sur  Ajouter.
  4. Fournissez des détails sur l'aspect.
  5. Facultatif : indiquez la justification de votre modification.
  6. Cliquez sur Envoyer pour examen.

Le système enregistre une nouvelle demande de modification et en informe l'approbateur. Vous pouvez suivre la progression de la demande sur la page Workflows de gouvernance, sous l'onglet Mes demandes.

REST

Pour demander l'association ou la mise à jour d'un aspect Contacts sur une entrée, utilisez la méthode entryGroups.requestCatalogChange :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "aspects": {
          "dataplex-types.global.contacts": {
            "data": {
              "identities": [
                {
                  "role": "Data Steward",
                  "name": "Dana",
                  "id": "dana@example.com"
                }
              ]
            }
          }
        }
      },
      "updateMask": {
        "paths": [
          "aspects"
        ]
      },
      "aspectKeys": [
        "dataplex-types.global.contacts"
      ]
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • LOCATION : région dans laquelle se trouve le groupe d'entrées, par exemple us-central1.
  • ENTRY_GROUP_ID : ID du groupe d'entrées parent.
  • ENTRY_ID : ID de l'entrée cible.
  • JUSTIFICATION : explication de la raison pour laquelle vous proposez la modification.

Le service renvoie une réponse contenant le nom de ressource de la demande de modification. Le système consigne une nouvelle demande de modification et en informe l'approbateur.

Créer un lien d'entrée

Console

Pour demander la création d'un lien d'entrée (par exemple, pour associer un terme de glossaire), procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Rechercher de Knowledge Catalog.

    Accéder à la recherche

  2. Recherchez et sélectionnez l'entrée d'élément de données à laquelle vous souhaitez associer un terme.

  3. Sur la page des détails de l'entrée, effectuez l'une des opérations suivantes :

    • Pour associer un terme à l'entrée, accédez à l'onglet Détails, puis cliquez sur Ajouter dans la section Termes du glossaire.
    • Pour associer un terme à une colonne, dans l'onglet Schéma, sélectionnez la colonne, puis cliquez sur Ajouter un terme métier.

  4. Recherchez et sélectionnez le terme à associer.

  5. Facultatif : indiquez une justification pour votre modification.

  6. Cliquez sur Envoyer pour examen.

Le système enregistre une nouvelle demande de modification et en informe l'approbateur. Vous pouvez suivre la progression de la demande sur la page Workflows de gouvernance, sous l'onglet Mes demandes.

REST

Pour demander la création d'un lien de définition entre un terme de glossaire et une entrée d'élément de données, utilisez la méthode entryGroups.requestCatalogChange :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryLinkRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryLinkId": "sample-definition-link",
      "entryLink": {
        "entryLinkType": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
        "entryReferences": [
          {
            "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
            "type": "SOURCE"
          },
          {
            "name": "projects/PROJECT_ID/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_ID/locations/global/glossaries/GLOSSARY_ID/terms/TERM_ID",
            "type": "TARGET"
          }
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • LOCATION : région dans laquelle se trouve le groupe d'entrées, par exemple us-central1.
  • ENTRY_GROUP_ID : ID du groupe d'entrées parent.
  • ENTRY_ID : ID de l'entrée cible.
  • GLOSSARY_ID : ID du glossaire contenant le terme.
  • TERM_ID : ID du terme du glossaire.
  • JUSTIFICATION : explication de la raison pour laquelle vous proposez la modification.

Le service renvoie une réponse contenant le nom de ressource de la demande de modification. Le système consigne une nouvelle demande de modification et en informe l'approbateur.

Supprimer un lien d'entrée

Console

Pour demander la suppression d'un lien d'entrée (par exemple, pour supprimer un terme de glossaire associé), procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Rechercher de Knowledge Catalog.

    Accéder à la recherche

  2. Recherchez et sélectionnez l'entrée d'élément de données dont vous souhaitez supprimer un terme associé.

  3. Sur la page des détails de l'entrée, effectuez l'une des opérations suivantes :

    • Pour supprimer un terme de l'entrée, dans l'onglet Détails, dans la section Termes du glossaire, cliquez sur le terme, puis sur  Supprimer.
    • Pour supprimer un terme d'une colonne, cliquez sur  Supprimer à côté du terme dans l'onglet Schéma.

  4. Facultatif : indiquez une justification pour votre modification.

  5. Cliquez sur Envoyer pour examen.

Le système enregistre une nouvelle demande de modification et en informe l'approbateur. Vous pouvez suivre la progression de la demande sur la page Workflows de gouvernance, sous l'onglet Mes demandes.

REST

Pour demander la suppression d'un lien d'entrée entre un terme de glossaire et une entrée d'élément de données, utilisez la méthode entryGroups.requestCatalogChange :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryLinkRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • LOCATION : région dans laquelle se trouve le groupe d'entrées, par exemple us-central1.
  • ENTRY_GROUP_ID : ID du groupe d'entrées parent.
  • ENTRY_LINK_ID : ID du lien d'entrée cible que vous souhaitez supprimer.
  • JUSTIFICATION : explication de la raison pour laquelle vous proposez la modification.

Le service renvoie une réponse contenant le nom de ressource de la demande de modification. Le système consigne une nouvelle demande de modification et en informe l'approbateur.

Étapes suivantes