Promouvoir une tâche de migration

Pour les migrations continues, vous pouvez lancer le processus de promotion lorsqu'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 un job de migration ou promouvoir des bases de données sélectionnées à partir d'un job de migration.

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

    Sources Cloud SQL pour SQL Server

    Pour les sources Cloud SQL pour SQL Server, Database Migration Service gère automatiquement la surveillance des exportations de journaux de transactions. Vous n'avez aucune autre action à effectuer après avoir arrêté les écritures sur l'instance source. Vous pouvez procéder à la promotion du job de migration.

    Sources autogérées ou Amazon RDS

    Pour les sources autogérées ou Amazon RDS, vous pouvez obtenir ce résultat en effectuant l'une des actions suivantes :

  3. Exécutez l'action de promotion :

    Console

    Vous pouvez promouvoir un job de migration depuis Database Migration Service ou depuis la page de l'instance de destination.

    Dans Database Migration Service :

    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 d'informations sur le job de migration s'ouvre.

    3. Effectuez l'une des actions de promotion suivantes :
      • Si vous souhaitez promouvoir toutes les bases de données, cliquez sur Promouvoir dans la barre d'outils.
      • Si vous souhaitez promouvoir uniquement des bases de données spécifiques, sélectionnez-les dans l'onglet Bases de données, puis cliquez sur Promouvoir.
    4. Dans la boîte de dialogue, vérifiez qu'aucune erreur ne s'affiche, puis cliquez sur Promouvoir.

    Depuis l'instance de destination :

    1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

      Accéder à la page Instances Cloud SQL

    2. Cliquez sur le nom à afficher de l'instance de destination de votre migration.

      La page des détails de l'instance s'affiche.

    3. Dans la section Migration, cliquez sur Promouvoir.
    4. Dans la boîte de dialogue, vérifiez 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 d'une région donnée et afficher leurs identifiants.

    • REGION par l'identifiant de la région où votre profil de connexion est enregistré.
    • Facultatif : Database Migration Service migre par défaut toutes les bases de données de votre source. Si vous ne souhaitez migrer que des bases de données spécifiques, utilisez l'option --databases-filter et spécifiez leurs identifiants sous la forme d'une liste d'éléments séparés par une virgule.

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

      Vous pourrez modifier ultérieurement 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

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

    Windows (PowerShell)

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

    Windows (cmd.exe)

    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é d'opération 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 l'opération a réussi, vous pouvez interroger l'objet d'opération renvoyé ou vérifier l'état du job de migration :
  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 du job de migration passe à Completed.
  5. L'application peut désormais être connectée à l'instance Cloud SQL, et le job de migration peut être supprimé en toute sécurité.