Créer un job de migration vers une instance de destination existante

MySQL   |  PostgreSQL   |  PostgreSQL vers AlloyDB

Database Migration Service utilise des jobs de migration pour migrer des données de votre instance de base de données source vers l'instance de base de données de destination. La création d'un job de migration pour une instance de destination existante comprend les éléments suivants :

• Définir les paramètres du job de migration
• Sélectionner le profil de connexion à la base de données source
• Sélectionner l'instance de base de données de destination existante
• Rétrograder l'instance existante pour la convertir en instance répliquée avec accès en lecture
• Configurer la connectivité entre les instances de base de données source et de destination
• Tester le job de migration pour vous assurer que les informations de connexion fournies pour le job sont valides

Vous devez tenir compte de certaines limites lorsque vous souhaitez migrer vers une instance de destination créée en dehors de Database Migration Service. Par exemple, votre instance de destination Cloud SQL doit être vide ou ne contenir que des données de configuration système. Pour en savoir plus, consultez Limites connues.

Définir les paramètres du job de migration

1. Dans la console Google Cloud , accédez à la page Jobs de migration.

   Accéder à la page "Jobs de migration"

2. Cliquez sur Créer un job de migration.

   La page de l'assistant de configuration du job de migration s'ouvre. Cet assistant contient plusieurs panneaux qui vous guident à travers chaque étape de la configuration.

   Vous pouvez suspendre la création d'un job de migration à tout moment en cliquant sur ENREGISTRER ET QUITTER. Toutes les données que vous saisissez jusqu'à ce point sont enregistrées dans un brouillon de tâche de migration. Vous pourrez terminer votre brouillon de tâche de migration plus tard.

3. Sur la page Premiers pas, saisissez les informations suivantes :
   1. Nom de la tâche de migration

      Nom lisible de votre tâche de migration. Cette valeur s'affiche dans la console Google Cloud .

   2. ID du job de migration

      Il s'agit d'un identifiant lisible par machine pour votre job de migration. Vous utilisez cette valeur pour travailler avec les jobs de migration à l'aide des commandes Google Cloud CLI ou de l'API Database Migration Service.

   3. Dans la liste Moteur de base de données source, sélectionnez MySQL.

      Le champ Moteur de base de données de destination est renseigné automatiquement et ne peut pas être modifié.

   4. Sélectionnez la région dans laquelle vous enregistrez le job de migration.

      Database Migration Service est un produit entièrement régional. Cela signifie que toutes les entités liées à votre migration (profils de connexion source et de destination, tâches de migration, bases de données de destination) doivent être enregistrées dans une seule région. Sélectionnez la région en fonction de l'emplacement des services qui ont besoin de vos données (comme les instances Compute Engine, les applications App Engine ou d'autres services). Une fois la région de destination choisie, vous ne pourrez plus la modifier.

      Important : Si vous prévoyez d'utiliser l'édition Enterprise Plus de Cloud SQL pour MySQL, assurez-vous que votre région est compatible avec cette édition. Consultez Compatibilité régionale de l'édition Enterprise Plus de Cloud SQL pour MySQL.
4. Cliquez sur Enregistrer et continuer.

Spécifier des informations sur le profil de connexion source

Sur la page Définir une source, procédez comme suit :

1. Dans le menu déroulant Profil de connexion source, sélectionnez le profil de connexion de votre base de données source.
2. Dans la section Personnaliser la configuration du vidage complet, cliquez sur Modifier la configuration.
3. Dans le panneau Modifier la configuration de vidage complet, sélectionnez l'une des options suivantes dans le menu déroulant Méthode de vidage complet :
   • Basée sur un fichier physique : sélectionnez cette option si vous souhaitez utiliser l'utilitaire Percona XtraBackup pour fournir votre propre fichier de sauvegarde. Cette approche nécessite des étapes de préparation supplémentaires. Pour obtenir le guide complet sur l'utilisation des fichiers de sauvegarde physiques générés par Percona XtraBackup, consultez Migrer vos bases de données à l'aide d'un fichier physique Percona XtraBackup.
   • Basée sur la logique : sélectionnez cette option si vous souhaitez utiliser un fichier de sauvegarde logique créé par l'utilitaire mysqldump. Database Migration Service peut générer automatiquement ce fichier de sauvegarde pour vous, ou vous pouvez fournir votre propre copie.
4. Modifiez les autres paramètres de vidage. Effectuez l'une des opérations suivantes :
   • Si vous utilisez le fichier de sauvegarde physique, dans Indiquez votre dossier, cliquez sur Parcourir, puis sélectionnez le dossier dans lequel vous avez importé votre fichier de dump complet. Veillez à sélectionner le dossier dédié contenant le fichier de sauvegarde complet, et non le bucket de stockage lui-même.

   • Si vous utilisez un fichier de sauvegarde logique, configurez le parallélisme du vidage des données ou les indicateurs de vidage.

     Développer cette section pour obtenir la procédure complète de sauvegarde logique

     Dans la section Choisir le mode de génération du fichier de dump, utilisez l'une des options suivantes :

     1. Généré automatiquement (recommandé)

        Cette option est recommandée, car Database Migration Service génère toujours un fichier de dump initial de la base de données une fois le job de migration créé et démarré.

        Database Migration Service utilise ce fichier pour reproduire les définitions d'objet et les données de table d'origine de votre base de données source afin que ces informations puissent être migrées vers une instance de base de données Cloud SQL de destination.

        Si vous utilisez le vidage généré automatiquement, sélectionnez le type d'opération que Database Migration Service doit effectuer dans la section Configurer l'opération de vidage des données :

        • Parallélisme du vidage des données : utilisez une option de parallélisme hautes performances, disponible lors de la migration vers MySQL versions 5.7 ou 8.
          Si vous choisissez d'utiliser le parallélisme de vidage des données, assurez-vous de fournir les privilèges nécessaires sur la base de données source pour votre scénario (par exemple, LOCK_TABLES). Pour en savoir plus sur les autorisations requises pour les bases de données sources, consultez Configurer la base de données source.

          La vitesse du parallélisme des données est liée à la charge induite sur votre base de données source :

          • Optimale (recommandée) : performances équilibrées avec une charge optimale sur la base de données source.
          • Maximum : offre les vitesses de vidage les plus élevées, mais peut entraîner une charge accrue sur la base de données source.
          • Minimum : utilise la plus faible quantité de ressources de calcul sur la base de données source, mais le débit de vidage peut être plus lent.
        • Options de vidage : cette option est exclusive avec Parallélisme du vidage des données. Utilisez ce paramètre pour configurer directement les indicateurs de l'utilitaire mysqldump utilisé pour créer le fichier de dump.

          Pour ajouter un drapeau :

          1. Cliquez sur AJOUTER UNE OPTION.

          2. Sélectionnez l'un des indicateurs suivants :

             • add-locks: : ce flag entoure chaque table contenue dans le fichier de dump avec des instructions LOCK TABLES et UNLOCK TABLES. Cela permet d'accélérer les insertions lorsque le fichier de dump est chargé dans l'instance de destination.
             • ignore-error: Utilisez cette option pour saisir une liste de numéros d'erreur séparés par une virgule. Ces nombres représentent les erreurs que l'utilitaire mysqldump ignorera.
             • max-allowed-packet: Utilisez cet indicateur pour définir la taille maximale du tampon pour la communication entre le client MySQL et la base de données MySQL source. La taille par défaut de la mémoire tampon est de 24 Mo, et la taille maximale est de 1 Go.
               Si vous utilisez de grandes colonnes BLOB ou de longues chaînes dans les tables de la base de données source, vous devez augmenter la taille du tampon pour cette option.
             Pour en savoir plus sur ces indicateurs, consultez la documentation sur l'utilitaire mysqldump dans le manuel de référence MySQL 8.0.
          3. Cliquez sur OK.
          4. Répétez ces étapes pour chaque indicateur que vous souhaitez ajouter.

          Pour supprimer un indicateur, cliquez sur l'icône de corbeille à droite de la ligne contenant l'indicateur.

     2. Fournir vos propres libellés

        Cette option est déconseillée, car par défaut, Database Migration Service effectue un vidage initial lors de l'exécution du job de migration.

        Si vous souhaitez utiliser votre propre fichier de dump, sélectionnez Fournir le vôtre, cliquez sur PARCOURIR, sélectionnez votre fichier (ou l'intégralité du dossier Cloud Storage si vous utilisez plusieurs fichiers), puis cliquez sur SÉLECTIONNER.

        Assurez-vous que le fichier de vidage a été généré au cours des dernières 24 heures et qu'il respecte les exigences relatives aux fichiers de vidage.

5. Cliquez sur Enregistrer et continuer.

Sélectionnez l'instance Cloud SQL de destination.

1. Dans le menu Type d'instance de destination, sélectionnez Instance existante.
2. Dans la section Sélectionner une instance de destination, sélectionnez votre instance de destination.
3. Examinez les informations de la section Détails de l'instance, puis cliquez sur Sélectionner et continuer.
4. Pour migrer vers une base de données de destination existante, Database Migration Service rétrograde l'instance cible et la convertit en réplica. Pour indiquer que la rétrogradation peut être effectuée sans risque, saisissez l'identifiant de l'instance de destination dans la fenêtre de confirmation.
5. Cliquez sur Confirmer et continuer.

Configurer la connectivité entre les instances de base de données source et de destination

Dans le menu déroulant Méthode de connectivité, sélectionnez une méthode de connectivité réseau. Cette méthode définit la manière dont l'instance Cloud SQL créée se connecte à la base de données source. Les méthodes de connectivité réseau actuelles incluent les listes d'autorisation d'adresses IP, les tunnels SSH inversés, les interfaces Private Service Connect et l'appairage de réseaux VPC.

Si vous souhaitez utiliser…	Alors…
la méthode de connectivité réseau de la liste d'autorisation d'adresses IP ;	Vous devez spécifier l'adresse IP sortante de votre instance de destination. Si l'instance Cloud SQL que vous avez créée est une instance à haute disponibilité, incluez les adresses IP sortantes pour l'instance principale et l'instance secondaire.
La méthode de connectivité réseau du tunnel SSH inversé	Vous devez sélectionner l'instance de VM Compute Engine qui hébergera le tunnel. Après avoir spécifié l'instance, Google fournira un script qui effectue les étapes de configuration du tunnel entre les bases de données source et de destination. Vous devrez exécuter le script dans la Google Cloud CLI. Exécutez les commandes depuis une machine connectée à la fois à la base de données source et à Google Cloud.
La méthode de connectivité des interfaces Private Service Connect	Database Migration Service établit automatiquement les connexions requises. Cette méthode de connectivité n'est disponible que si vous disposez de l'instance compatible avec Private Service Connect et d'un rattachement réseau. Pour en savoir plus sur les interfaces Private Service Connect, consultez Connexions sortantes Private Service Connect dans la documentation Cloud SQL.
la méthode de connectivité réseau par appairage de VPC ;	Vous devez sélectionner le réseau VPC sur lequel réside la base de données source. L'instance Cloud SQL sera mise à jour afin de se connecter à ce réseau.

Après avoir sélectionné et configuré la connectivité réseau, cliquez sur Configurer et continuer.

Tester, créer et exécuter le job de migration

Lors de cette dernière étape, vérifiez le récapitulatif des paramètres de la tâche de migration, de la source, de la destination et de la méthode de connectivité, puis testez la validité de la configuration de la tâche de migration. Si vous rencontrez des problèmes, vous pouvez modifier les paramètres du job de migration. Tous les paramètres ne sont pas modifiables.

1. Sur la page Tester et créer une tâche de migration, cliquez sur Tester la tâche.

   Si le test échoue, vous pouvez résoudre le problème dans la partie appropriée du flux, puis revenir au test. Pour savoir comment résoudre les problèmes liés à un test de tâche de migration qui échoue, consultez Diagnostiquer les problèmes liés à MySQL.

2. Une fois le test du job de migration terminé, cliquez sur Créer et démarrer le job pour créer le job de migration et le démarrer immédiatement, ou cliquez sur Créer le job pour créer le job de migration sans le démarrer immédiatement.

   Si le job n'est pas démarré au moment de sa création, il peut l'être depuis la page Jobs de migration en cliquant sur DÉMARRER. Quel que soit le moment où le job de migration démarre, votre organisation est facturée pour l'existence de l'instance de destination.

   Votre migration est en cours. Lorsque vous démarrez le job de migration, Database Migration Service lance le vidage complet, ce qui verrouille brièvement la base de données source. Si votre source se trouve dans Amazon RDS ou Amazon Aurora, Database Migration Service nécessite également un bref temps d'arrêt d'écriture (environ moins d'une minute) au début de la migration. Pour en savoir plus, consultez Limites connues.

   Attention : Si vous avez utilisé Terraform pour provisionner votre base de données de destination, vous risquez de rencontrer une dérive de configuration lors de l'exécution du job de migration. N'essayez pas de réappliquer les paramètres Terraform avant la fin de la migration. Pour en savoir plus, consultez Dérive de configuration Terraform.
3. Passez à la section Examiner le job de migration.

Créer un job de migration à l'aide de Google Cloud CLI

Lorsque vous migrez vers une instance existante à l'aide de Google Cloud CLI, vous devez créer manuellement le profil de connexion pour l'instance de destination. Cette étape n'est pas nécessaire lorsque vous utilisez la console Google Cloud , car Database Migration Service se charge de créer et de supprimer le profil de connexion de destination pour vous.

Avant de commencer

Avant d'utiliser la gcloud CLI pour créer un job de migration vers une instance de base de données de destination existante, assurez-vous de :

• Créez votre instance de base de données de destination.
• Préparez votre instance de base de données source. Consultez les ressources suivantes :
  • Configurer votre source
  • Créez le profil de connexion source (l'identifiant du profil de connexion source est requis pour créer un job de migration).
  • Configurer la connectivité

Créer un profil de connexion de destination

Créez le profil de connexion de destination pour votre instance de destination existante en exécutant la commande gcloud database-migration connection-profiles create :

Cet exemple utilise l'option facultative --no-async pour que toutes les opérations soient effectuées de manière synchrone. Cela signifie que l'exécution de certaines commandes peut prendre un certain temps. Vous pouvez ignorer l'option --no-async pour exécuter les commandes de manière asynchrone. Si c'est le cas, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si votre opération a réussi.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

• CONNECTION_PROFILE_ID avec un identifiant lisible par machine pour votre profil de connexion.
• REGION par l'identifiant de la région dans laquelle vous souhaitez enregistrer le profil de connexion.
• DESTINATION_INSTANCE_ID par l'identifiant d'instance de votre instance de destination.
• (Facultatif) Remplacez CONNECTION_PROFILE_NAME par un nom lisible pour votre profil de connexion. Cette valeur s'affiche dans la console Google Cloud .

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration connection-profiles \
create mysql CONNECTION_PROFILE_ID \
  --no-async \
  --cloudsql-instance=DESTINATION_INSTANCE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration connection-profiles `
create mysql CONNECTION_PROFILE_ID `
  --no-async `
  --cloudsql-instance=DESTINATION_INSTANCE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration connection-profiles ^
create mysql CONNECTION_PROFILE_ID ^
  --no-async ^
  --cloudsql-instance=DESTINATION_INSTANCE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME

Vous devriez obtenir un résultat semblable à celui-ci :

Waiting for connection profile [CONNECTION_PROFILE_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

Créer le job de migration

Remarque : Les exemples suivants représentent un scénario de migration dans lequel vous utilisez la connectivité par adresse IP privée entre les bases de données source et de destination. Si vous utilisez un autre type de connectivité (par exemple, l'appairage de VPC ou un tunnel SSH inversé), veillez à ajouter les indicateurs requis, tels que --peer-vpc ou --vm, --vm-ip, --vm-port, --vpc. Pour en savoir plus, consultez Configurer la connectivité et Exemples Google Cloud CLI.

Cet exemple utilise l'option facultative --no-async pour que toutes les opérations soient effectuées de manière synchrone. Cela signifie que l'exécution de certaines commandes peut prendre un certain temps. Vous pouvez ignorer l'option --no-async pour exécuter les commandes de manière asynchrone. Si c'est le cas, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si votre opération a réussi.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

• MIGRATION_JOB_ID par un identifiant lisible par machine pour votre job de migration. Vous utilisez cette valeur pour travailler avec les jobs de migration à l'aide des commandes Google Cloud CLI ou de l'API Database Migration Service.
• REGION par l'identifiant de la région dans laquelle vous souhaitez enregistrer le job de migration.
• MIGRATION_JOB_NAME par un nom lisible pour votre job de migration. Cette valeur s'affiche dans la console Google Cloud de Database Migration Service.
• SOURCE_CONNECTION_PROFILE_ID avec un identifiant lisible par machine du profil de connexion source.
• DESTINATION_CONNECTION_PROFILE_ID avec un identifiant lisible par machine du profil de connexion de destination.

• Facultatif : Database Migration Service migre toutes les bases de données de votre source par défaut. Si vous souhaitez migrer uniquement des bases de données spécifiques, utilisez l'indicateur --databases-filter et spécifiez leurs identifiants sous forme de liste séparée par des virgules.

  Par exemple : --databases-filter=my-business-database,my-other-database

  Vous pouvez ensuite modifier les jobs de migration que vous avez créés avec --database-filter flag à l'aide de la commande gcloud database-migration migration-jobs update.

• MIGRATION_JOB_TYPE avec le type de votre job de migration. Deux valeurs sont autorisées : ONE_TIME ou CONTINUOUS. Pour en savoir plus, consultez Types de migration.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs \
create MIGRATION_JOB_ID \
  --no-async \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME \
  --source=SOURCE_CONNECTION_PROFILE_ID \
  --destination=DESTINATION_CONNECTION_PROFILE_ID \
  --type=MIGRATION_JOB_TYPE \

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs `
create MIGRATION_JOB_ID `
  --no-async `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME `
  --source=SOURCE_CONNECTION_PROFILE_ID `
  --destination=DESTINATION_CONNECTION_PROFILE_ID `
  --type=MIGRATION_JOB_TYPE `

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs ^
create MIGRATION_JOB_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME ^
  --source=SOURCE_CONNECTION_PROFILE_ID ^
  --destination=DESTINATION_CONNECTION_PROFILE_ID ^
  --type=MIGRATION_JOB_TYPE ^

Vous devriez obtenir un résultat semblable à celui-ci :

Waiting for migration job [MIGRATION_JOB_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created migration job MIGRATION_JOB_ID [OPERATION_ID]

Rétrograder la base de données de destination

Database Migration Service exige que l'instance de base de données de destination fonctionne comme une instance répliquée avec accès en lecture pendant la migration. Avant de démarrer la tâche de migration, exécutez la commande gcloud database-migration migration-jobs demote-destination pour rétrograder l'instance de base de données de destination.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

• MIGRATION_JOB_ID par l'identifiant de votre job de migration.

  Si vous ne connaissez pas l'identifiant, vous pouvez utiliser la commande gcloud database-migration migration-jobs list pour lister tous les jobs de migration dans une région donnée et afficher leurs identifiants.

• REGION par l'identifiant de la région dans laquelle votre profil de connexion est enregistré.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs \
demote-destination MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs `
demote-destination MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs ^
demote-destination MIGRATION_JOB_ID ^
  --region=REGION

Résultat

L'action est effectuée de manière asynchrone. Par conséquent, cette commande renvoie une entité Operation qui représente une opération de longue durée :

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: demote-destination
name: OPERATION_ID

Pour vérifier si votre opération a réussi, vous pouvez interroger l'objet d'opération renvoyé ou vérifier l'état du job de migration :

• Utilisez la commande gcloud database-migration migration-jobs describe pour afficher l'état du job de migration.
• Utilisez gcloud database-migration operations describe avec OPERATION_ID pour afficher l'état de l'opération elle-même.

Gérer les tâches de migration

À ce stade, votre job de migration est configuré et connecté à votre instance de base de données de destination. Vous pouvez le gérer à l'aide des opérations verify, start, stop, restart et resume.

Vérifier le job de migration

Nous vous recommandons de commencer par valider votre job de migration en exécutant la commande gcloud database-migration migration-jobs verify.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

• MIGRATION_JOB_ID par l'identifiant de votre job de migration.

  Si vous ne connaissez pas l'identifiant, vous pouvez utiliser la commande gcloud database-migration migration-jobs list pour lister tous les jobs de migration dans une région donnée et afficher leurs identifiants.

• REGION par l'identifiant de la région dans laquelle votre profil de connexion est enregistré.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs \
verify MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs `
verify MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs ^
verify MIGRATION_JOB_ID ^
  --region=REGION

Résultat

L'action est effectuée de manière asynchrone. Par conséquent, cette commande renvoie une entité Operation qui représente une opération de longue durée :

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: verify
name: OPERATION_ID

Pour vérifier si votre opération a réussi, vous pouvez interroger l'objet d'opération renvoyé ou vérifier l'état du job de migration :

• Utilisez la commande gcloud database-migration migration-jobs describe avec MIGRATION_JOB_ID pour afficher l'état du job de migration.
• Utilisez la commande gcloud database-migration operations describe avec OPERATION_ID pour afficher l'état de l'opération elle-même.

Démarrer le job de migration

Démarrez le job de migration en exécutant la commande gcloud database-migration migration-jobs start.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

• MIGRATION_JOB_ID par l'identifiant de votre job de migration.

  Si vous ne connaissez pas l'identifiant, vous pouvez utiliser la commande gcloud database-migration migration-jobs list pour lister tous les jobs de migration dans une région donnée et afficher leurs identifiants.

• REGION par l'identifiant de la région dans laquelle votre profil de connexion est enregistré.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs \
start MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs `
start MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs ^
start MIGRATION_JOB_ID ^
  --region=REGION

Résultat

L'action est effectuée de manière asynchrone. Par conséquent, cette commande renvoie une entité Operation qui représente une opération de longue durée :

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: start
name: OPERATION_ID

Pour vérifier si votre opération a réussi, vous pouvez interroger l'objet d'opération renvoyé ou vérifier l'état du job de migration :

• Utilisez la commande gcloud database-migration migration-jobs describe avec MIGRATION_JOB_ID pour afficher l'état du job de migration.
• Utilisez la commande gcloud database-migration operations describe avec OPERATION_ID pour afficher l'état de l'opération elle-même.

Promouvoir la tâche de migration

Une fois la migration arrivée à la phase de capture des données modifiées (CDC, Change Data Capture), vous pouvez promouvoir l'instance de base de données de destination d'une réplique en lecture seule à une instance autonome. Exécutez la commande gcloud database-migration migration-jobs promote :

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

• MIGRATION_JOB_ID par l'identifiant de votre job de migration.

  Si vous ne connaissez pas l'identifiant, vous pouvez utiliser la commande gcloud database-migration migration-jobs list pour lister tous les jobs de migration dans une région donnée et afficher leurs identifiants.

• REGION par l'identifiant de la région dans laquelle votre profil de connexion est enregistré.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs \
promote MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs `
promote MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs ^
promote MIGRATION_JOB_ID ^
  --region=REGION

Résultat

L'action est effectuée de manière asynchrone. Par conséquent, cette commande renvoie une entité Operation qui représente une opération de longue durée :

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: start
name: OPERATION_ID

Pour vérifier si votre opération a réussi, vous pouvez interroger l'objet d'opération renvoyé ou vérifier l'état du job de migration :

• Utilisez la commande gcloud database-migration migration-jobs describe avec MIGRATION_JOB_ID pour afficher l'état du job de migration.
• Utilisez la commande gcloud database-migration operations describe avec OPERATION_ID pour afficher l'état de l'opération elle-même.