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. Arrêtez 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 des fichiers journaux de transactions sont répliquées vers l'instance Cloud SQL de destination.
  3. Attendez que la métrique de délai de réplication soit égale ou proche de zéro. Cela signifie que le job de migration a traité toutes les modifications en attente.

    Vous pouvez promouvoir une migration même si le délai de réplication n'est pas nul. Cela peut réduire le temps d'arrêt de la base de données, mais peut affecter la précision des données dans la destination.

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

    4. 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 de promotion du job de migration s'affiche.

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

        La boîte de dialogue s'affiche avec le nombre de bases de données que vous souhaitez promouvoir.

    5. 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é.

    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 :

  5. 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.
  6. L'application peut désormais être connectée à l'instance Cloud SQL, et le job de migration peut être supprimé en toute sécurité.

Étapes suivantes