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 étapes suivantes:

• Définir les paramètres du job de migration
• Sélectionner le profil de connexion de la base de données source
• Sélectionner l'instance de base de données de destination existante
• Réduire l'instance existante pour la convertir en instance dupliquée avec accès en lecture
• Configurer la connectivité entre les instances de base de données source et de destination
• Tester la tâche de migration pour vous assurer que les informations de connexion fournies pour la tâche 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 la section 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 de la tâche de migration s'ouvre. Cet assistant contient plusieurs panneaux qui vous guident à chaque étape de la configuration.

   Vous pouvez suspendre la création d'une tâche 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 tâche de migration d'essai plus tard.

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

      Il s'agit d'un nom lisible pour 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 de votre tâche 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 la tâche de migration.

      Database Migration Service est un produit entièrement régional, ce qui 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 ou les applications App Engine, et d'autres services). Une fois que vous avez choisi la région de destination, vous ne pouvez plus modifier cette sélection.

      Important:Si vous prévoyez d'utiliser l'édition Cloud SQL pour MySQL Enterprise Plus, assurez-vous que votre région est compatible avec cette édition. Consultez la section 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é sur le 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é 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 de vidage des données ou les indicateurs de vidage.

     Développez cette section pour obtenir la procédure complète de sauvegarde logique des fichiers.

     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 de base de données initial après la création et le démarrage du job de migration.

        Database Migration Service utilise ce fichier pour reproduire les définitions d'objets 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 de données:

        • Parallélisme de vidage de données: utilisez une option de parallélisme hautes performances, disponible lors de la migration vers les versions 5.7 ou 8 de MySQL.
          Si vous choisissez d'utiliser le parallélisme de vidage de données, assurez-vous de fournir les droits 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 la section 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:

          • Optimal (recommandé): performances équilibrées avec une charge optimale sur la base de données source.
          • Maximum: fournit 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 l'option 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 indicateur:

          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. Les insertions sont ainsi plus rapides lorsque le fichier de dump est chargé dans l'instance de destination.
             • ignore-error: Utilisez cet indicateur 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. 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 de la mémoire tampon pour cet indicateur.
             Pour en savoir plus sur ces options, 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 cette procédure pour chaque indicateur que vous souhaitez ajouter.

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

     2. Fournir les vôtres

        Cette option n'est pas recommandé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 PARCOURRIR, 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 dump a été généré au cours des dernières 24 heures et qu'il respecte les exigences concernant les vidages.

5. Cliquez sur Enregistrer et continuer.

Sélectionner 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. Vérifiez 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 instance répliquée. Pour indiquer que la rétrogradation peut être effectuée en toute sécurité, 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 actuelles de connectivité réseau incluent la liste d'autorisation d'adresses IP, le tunnel SSH inverse et l'appairage VPC.

Si vous souhaitez utiliser…	Alors…
la méthode de connectivité réseau par 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 de l'instance principale et de l'instance secondaire.
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 fournit 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 à partir d'une machine connectée à la fois à la base de données source et à Google Cloud.
la méthode de connectivité réseau d'appairage VPC ;	Vous devez sélectionner le réseau VPC sur lequel est hébergée la base de données source. L'instance Cloud SQL est 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 la tâche de migration

Lors de cette dernière étape, examinez le résumé des paramètres, de la source, de la destination et de la méthode de connectivité de la tâche de migration, puis testez la validité de la configuration de la tâche de migration. En cas de problème, vous pouvez modifier les paramètres de la tâche 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 obtenir des informations sur le dépannage d'un test de tâche de migration qui échoue, consultez la section Diagnostiquer les problèmes liés à MySQL.

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

   Si la tâche n'est pas démarrée au moment de sa création, vous pouvez la démarrer sur la page Tâches de migration en cliquant sur DÉMARRER. Quelle que soit la date de début du job de migration, votre organisation est facturée pour l'existence de l'instance de destination.

   Votre migration est en cours. Lorsque vous démarrez la tâche de migration, Database Migration Service lance le vidage complet, en bloquant 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 la section Limites connues.

   Attention:Si vous avez utilisé Terraform pour provisionner votre base de données de destination, vous risquez de constater 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 la section Écart de configuration Terraform.
3. Passez à l'étape Examiner la tâche de migration.

Créer une tâche de migration à l'aide de la Google Cloud CLI

Lorsque vous effectuez une migration vers une instance existante à l'aide de Google Cloud CLI, vous devez créer manuellement le profil de connexion de l'instance de destination. Ce 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.

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 une tâche 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 --no-async facultative afin que toutes les opérations soient effectuées de manière synchrone. Cela signifie que certaines commandes peuvent prendre un certain temps. Vous pouvez ignorer l'indicateur --no-async pour exécuter des commandes de manière asynchrone. Dans ce 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 de l'instance de votre instance de destination.
• (Facultatif) CONNECTION_PROFILE_NAME avec 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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 la tâche de migration

Remarque :Les exemples suivants représentent un scénario de migration dans lequel vous utilisez la connectivité 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 les pages Configurer la connectivité et Exemples de Google Cloud CLI.

Cet exemple utilise l'option --no-async facultative afin que toutes les opérations soient effectuées de manière synchrone. Cela signifie que certaines commandes peuvent prendre un certain temps. Vous pouvez ignorer l'indicateur --no-async pour exécuter des commandes de manière asynchrone. Dans ce 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 avec un identifiant lisible par machine pour votre tâche de migration. Vous utilisez cette valeur pour travailler avec les jobs de migration à l'aide des commandes ou de l'API Google Cloud CLI de Database Migration Service.
• REGION par l'identifiant de la région dans laquelle vous souhaitez enregistrer la tâche de migration.
• MIGRATION_JOB_NAME par un nom lisible pour votre tâche de migration. Cette valeur s'affiche dans Database Migration Service dans la console Google Cloud.
• 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.
• MIGRATION_JOB_TYPE par le type de votre tâche de migration. Deux valeurs sont autorisées: ONE_TIME ou CONTINUOUS. Pour en savoir plus, consultez la section Types de migration.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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]

Déclasser 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 au moment de 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 tâche de migration.

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

• REGION avec 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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 représentant 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 de la tâche de migration:

• Utilisez la commande gcloud database-migration migration-jobs describe pour afficher l'état de la tâche 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 tâche de migration est configurée et connectée à 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 vérifier votre tâche 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 tâche de migration.

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

• REGION avec 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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 représentant 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 de la tâche de migration:

• Utilisez la commande gcloud database-migration migration-jobs describe avec MIGRATION_JOB_ID pour afficher l'état de la tâche 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 la tâche de migration

Démarrez la tâche 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 tâche de migration.

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

• REGION avec 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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 représentant 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 de la tâche de migration:

• Utilisez la commande gcloud database-migration migration-jobs describe avec MIGRATION_JOB_ID pour afficher l'état de la tâche 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'un réplica de lecture à 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 tâche de migration.

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

• REGION avec 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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é Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou 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 représentant 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 de la tâche de migration :

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