Promouvoir une tâche de migration

Pour les migrations continues, vous pouvez lancer le processus de promotion une fois qu'il est temps de déplacer les lectures et les écritures vers les bases de données de destination. La promotion signifie que les bases de données Cloud SQL migrées sont désormais accessibles pour toutes les opérations de lecture et d'écriture.

Vous pouvez promouvoir une tâche de migration ou des bases de données sélectionnées à partir d'une tâche de migration.

1. Lancez la promotion. Pour éviter toute perte de données, veillez à arrêter toutes les écritures, les scripts en cours d'exécution et les connexions client à la base de données source. C'est ici que commence la période d'arrêt.
2. Assurez-vous que toutes les données disponibles des fichiers de journaux de transactions sont répliquées dans l'instance de destination Cloud SQL pour SQL Server.

   Pour ce faire, procédez comme suit:

   • Arrêtez les importations automatiques de fichiers de sauvegarde ou importez le dernier fichier de journal des transactions. Surveillez la taille des sauvegardes du journal des transactions non traitées pour déterminer quand Database Migration Service a terminé le traitement de ce fichier.
   • Vous pouvez éventuellement importer un fichier de journal des transactions dont le nom se termine par le suffixe .trn.final. Le service de migration de base de données arrête les chargements continus lorsqu'il détecte un fichier de sauvegarde dont le nom correspond à la convention d'attribution du suffixe .trn.final.

     Lorsque Database Migration Service a terminé le traitement de ce fichier, l'état de la tâche de migration passe à Prêt à promouvoir.

3. Effectuez l'action de promotion :

   Console

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

      Accéder à la page "Jobs de migration"

   2. Dans l'onglet Tâches, cliquez sur le nom à afficher de la tâche de migration que vous souhaitez promouvoir.

   La page d'informations sur la tâche de migration s'ouvre.

   3. Effectuez l'une des actions de promotion suivantes :

      • Si vous souhaitez promouvoir toutes les bases de données incluses dans la migration, cliquez sur Promouvoir dans la barre d'outils de la tâche de migration.

        La boîte de dialogue "Promouvoir la tâche de migration" s'affiche.

      • Si vous ne souhaitez promouvoir que des bases de données spécifiques, cochez les cases correspondantes à leurs noms, puis cliquez sur Promouvoir dans l'onglet Bases de données.

        La boîte de dialogue contenant un certain nombre de bases de données que vous souhaitez promouvoir s'affiche.

   4. Dans la boîte de dialogue, assurez-vous qu'aucune erreur ne s'affiche, puis cliquez sur Promouvoir.

   gcloud

   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 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.
4. L'instance de destination ou les bases de données que vous avez sélectionnées sont promues, et vos bases de données migrées sont désormais accessibles pour toutes les opérations de lecture et d'écriture. L'état de la tâche de migration passe à Completed.
5. L'application peut désormais être connectée à l'instance Cloud SQL et la tâche de migration peut être supprimée en toute sécurité.