Passer au glossaire d'entreprise dans Dataplex Universal Catalog

Ce document explique comment migrer en une seule étape de la version Preview du glossaire d'entreprise, qui était compatible avec les métadonnées Data Catalog, vers la version en disponibilité générale du glossaire d'entreprise, qui est compatible avec les métadonnées Dataplex Universal Catalog.

Remarque : Si vous avez déjà commencé le processus de migration manuelle de vos glossaires et que vous souhaitez accéder à ces instructions, consultez Passer manuellement au glossaire d'entreprise dans Dataplex Universal Catalog.

Avant de commencer

1. Installez gcloud ou les packages Python. Authentifiez votre compte utilisateur et les identifiants par défaut de l'application (ADC) utilisés par les bibliothèques Python. Exécutez les commandes suivantes et suivez les invites du navigateur :

   gcloud init
   gcloud auth login
   gcloud auth application-default login
   

2. Activez les API suivantes :

   • API Dataplex
   • API Data Catalog
   • API Cloud Resource Manager
   • API Cloud Storage

3. Créez un ou plusieurs buckets Cloud Storage dans l'un de vos projets. Les buckets serviront d'emplacement temporaire pour les fichiers d'importation. Plus vous fournissez de buckets, plus l'importation est rapide. Attribuez le rôle IAM d'administrateur de l'espace de stockage au compte de service qui exécute la migration :

   [e-mail]

   Remplacez MIGRATION_PROJECT_ID par le projet à partir duquel vous migrez les glossaires.

4. Configurez le dépôt :

   1. Clonez le dépôt :

      git clone https://github.com/GoogleCloudPlatform/dataplex-labs.git
      cd dataplex-labs/dataplex-quickstart-labs/00-resources/scripts/python/business-glossary-import
      

   2. Installez les packages requis :

      pip3 install -r requirements.txt
      cd migration
      

      Remarque : Si vous rencontrez des problèmes lors de l'installation du package, suivez les étapes pour créer un environnement virtuel Python.

Rôles requis

Exécuter le script de migration

python3 run.py --project=MIGRATION_PROJECT_ID --user-project=USER_PROJECT_ID --buckets=BUCKET1,BUCKET2

Remplacez les éléments suivants :

• USER_PROJECT_ID : ID du projet à migrer.
• BUCKET1 et BUCKET2 : ID des buckets Cloud Storage à utiliser pour l'importation.

Remarque : Vous pouvez fournir un ou plusieurs buckets. Plus vous fournissez de buckets, plus le processus de migration sera rapide.

Glossaires des champs d'application de la migration

Pour migrer uniquement des glossaires spécifiques, définissez leur portée en fournissant leurs URL respectives.

python3 run.py --project=MIGRATION_PROJECT_ID --user-project=USER_PROJECT_ID --buckets=BUCKET1,BUCKET2 --glossaries="GLOSSARY_URL1","GLOSSARY_URL2"

Remplacez GLOSSARY_URL1 (et GLOSSARY_URL2) par les URL des glossaires que vous migrez.

Remarque : Vous pouvez fournir une ou plusieurs URL de glossaire.

Reprendre la migration en cas d'échec des tâches d'importation

La présence de fichiers après la migration indique que certaines tâches d'importation ont échoué. Pour reprendre la migration, exécutez la commande suivante :

python3 run.py --project=MIGRATION_PROJECT_ID --user-project=USER_PROJECT_ID --buckets=BUCKET1,BUCKET2 --resume-import