Promouvoir une tâche de migration

Pour les migrations continues, vous pouvez lancer le processus de promotion une fois qu'il est temps de transférer 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, assurez-vous d'arrêter toutes les écritures, tous les scripts en cours d'exécution et toutes les connexions client à la base de données source. La période de temps d'arrêt commence ici.
2. Assurez-vous que toutes les données disponibles des fichiers journaux des transactions sont répliquées vers l'instance de destination Cloud SQL pour SQL Server.

   Pour ce faire, vous pouvez effectuer l'une des actions suivantes :

   • Arrêtez l' importation automatique de vos fichiers de sauvegarde ou importez le dernier fichier journal des transactions. Surveillez la taille des sauvegardes du journal des transactions non traitées pour déterminer quand Database Migration Service a fini de traiter ce fichier.
   • Vous pouvez éventuellement importer un fichier journal des transactions dont le nom se termine par le suffixe .trn.final. Database Migration Service arrête les chargements continus lorsqu'il détecte un fichier de sauvegarde dont le nom correspond à la convention de suffixe .trn.final.

     Lorsque Database Migration Service a terminé de traiter ce fichier, l'état du job de migration passe à Prêt à être promu.

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 Jobs, cliquez sur le nom à afficher du job de migration que vous souhaitez promouvoir.

   La page des détails du job 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 du job de migration.

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

      • Si vous souhaitez promouvoir uniquement des bases de données spécifiques, sélectionnez-les à l'aide des cases à cocher à côté de leur nom, puis cliquez sur Promouvoir dans l'onglet Bases de données.

        La boîte de dialogue contenant le 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 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é.

   • 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.

   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 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.
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 sans risque.