Afficher et gérer les tâches de migration

Dans la console Google Cloud , vous pouvez effectuer des actions groupées pour les jobs de migration qui ont le même état. Vous pouvez effectuer des actions sur un seul job de migration à la fois dans la console Google Cloud et à l'aide de Google Cloud CLI.

Vous pouvez effectuer l'une des actions suivantes sur votre tâche de migration :

Action Description
Démarrer Démarrer les tâches de migration qui ne sont pas à l'état En cours d'exécution ou Démarrage. Consultez États des jobs de migration.
Arrêter Arrêtez une tâche de migration en cours. Le transfert de données est suspendu. L'état de la tâche de migration passe d'abord à Stopping, puis à Stopped. Vous pouvez réactiver, supprimer ou promouvoir un job de migration arrêté.

Dans certains cas, la base de données source doit conserver les données jusqu'à ce que vous repreniez la tâche de migration. La période de conservation de la base de données source peut être limitée. Si la tâche de migration est mise en veille pendant une période plus longue que la période de conservation, puis reprise, cela peut entraîner son échec. Si cela se produit, supprimez ou redémarrez le job de migration.

Reprendre Vous pouvez reprendre les jobs de migration arrêtés pendant la phase CDC. Lorsque vous reprenez un job de migration, Database Migration Service reprend la réplication des événements de modification qui s'accumulent lorsque le job de migration est arrêté.
Redémarrer Vous pouvez redémarrer un job de migration qui a rencontré une erreur et ne peut pas poursuivre la réplication des données. Le résultat du redémarrage d'un job de migration dépend de la raison de son échec :
  • Si la réplication a échoué en raison d'une erreur sur une ou plusieurs tables de base de données source ou de destination, le redémarrage du job de migration efface toutes les données des tables de base de données de destination incluses dans le job de migration.
  • Le redémarrage du job de migration n'entraîne pas la réplication par Database Migration Service des nouvelles tables que vous avez créées dans la base de données source. Vous devez d'abord ajouter les tables à l'espace de travail de conversion et convertir leur schéma.
Modifier Consultez Modifier un job de migration.
Supprimer Vous pouvez supprimer une tâche de migration. Le résultat dépend de l'état du job :
  • Si la tâche de migration est à l'état Completed, l'enregistrement est supprimé de la liste des tâches de migration.
  • Si le job de migration est dans un autre état, vous pouvez choisir de supprimer le cluster AlloyDB pour PostgreSQL de destination associé.
Promouvoir Pendant le processus de migration, votre base de données de destination est mise en lecture seule et est entièrement gérée par Database Migration Service. Lorsque vous souhaitez basculer votre application vers la base de données de destination migrée, la promotion du job de migration met à jour la base de données de destination en réplique autonome. Consultez Promouvoir une migration.

Examiner une tâche de migration

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

    Accéder à la page "Jobs de migration"

  2. Sélectionnez un job de migration pour afficher sa page de détails, qui inclut les éléments suivants :
    • Métadonnées du job de migration, telles que le nom à afficher, l'ID, le type de migration, le profil de connexion source, le moteur de base de données source, la destination, la méthode de connectivité, la date et l'heure de création du job de migration, et la durée d'exécution du job de migration.
    • État et sous-état de la tâche de migration, ainsi que des informations supplémentaires. Différentes actions sont disponibles en fonction de l'état et du sous-état du job de migration.

Démarrer une tâche de migration

Une fois votre job de migration entièrement créé (c'est-à-dire qu'il n'est pas enregistré à l'état de brouillon), vous pouvez le démarrer à tout moment pour commencer la migration des données.

Pour démarrer un job de migration, procédez comme suit :

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 démarrer.

    La page des détails du job de migration s'ouvre.

  3. Cliquez sur Démarrer.
  4. Dans la boîte de dialogue, cliquez sur Démarrer.

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

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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 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 :

Arrêter une tâche de migration

Vous pouvez arrêter une tâche de migration en cours d'exécution à tout moment en procédant comme suit :

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 démarrer.

    La page des détails du job de migration s'ouvre.

  3. Cliquez sur Arrêter.
  4. Dans la boîte de dialogue, cliquez sur Arrêter.

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

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
stop 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: stop
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 :

Reprendre une tâche de migration

Vous pouvez reprendre un job de migration arrêté en procédant comme suit :

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 démarrer.

    La page des détails du job de migration s'ouvre.

  3. Cliquez sur Reprendre.
  4. Dans la boîte de dialogue, cliquez sur Reprendre.

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

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
resume 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: resume
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 :

Redémarrer une tâche de migration

Pour démarrer un job de migration, procédez comme suit :

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 redémarrer.

    La page des détails du job de migration s'ouvre.

  3. Cliquez sur Restart (Redémarrer).
  4. Dans la boîte de dialogue, cliquez sur Redémarrer.

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

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

Windows (PowerShell)

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

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
restart 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: restart
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 :

Modifier un brouillon de tâche de migration

Pour terminer de créer un job de migration, procédez comme suit :

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

    Accéder à la page "Jobs de migration"

  2. Dans l'onglet Brouillons, cliquez sur le nom à afficher du job de migration que vous souhaitez terminer de créer.

    L'assistant de création de tâches de migration s'ouvre.

  3. Terminez de créer le job de migration. Consultez Créer une tâche de migration.

Modifier un job de migration

Vous pouvez modifier les informations de configuration de la source, telles que les tables et les schémas de la base de données source que Database Migration Service migrera vers la destination. Database Migration Service utilise ces informations de configuration pour migrer les données appropriées de la source vers la destination.

Ajouter ou supprimer des objets de la migration

Pour ajouter ou supprimer des tables ou des schémas de la migration, procédez comme suit :

  1. Accédez à la page Jobs de migration de la console Google Cloud .

    Accéder à la page "Jobs de migration"

  2. Cliquez sur le nom à afficher du job de migration que vous souhaitez modifier. Une page de présentation s'affiche pour le job de migration.

  3. Dans la section Sélectionner les objets à migrer, cochez ou décochez les cases pour modifier les tables et les schémas de la source que Database Migration Service migrera vers la destination.

  4. Cliquez sur Enregistrer ou Enregistrer et redémarrer.

    • Si vous cliquez sur Enregistrer, Database Migration Service ne déplacera que les données historiques des schémas et des tables que vous sélectionnez.

    • Si vous cliquez sur Enregistrer et redémarrer, Database Migration Service lance la migration depuis le début, après avoir nettoyé les tables que vous sélectionnez dans la destination.

Ajuster le nombre maximal de connexions simultanées à la base de données source

Vous pouvez personnaliser le nombre maximal de connexions simultanées que Database Migration Service peut établir avec votre instance source pour la phase de vidage complet ou la phase de CDC.

  1. Accédez à la page Jobs de migration de la console Google Cloud .

    Accéder à la page "Jobs de migration"

  2. Cliquez sur le nom à afficher du job de migration que vous souhaitez modifier. Une page de présentation s'affiche pour le job de migration.

  3. Développez la section Personnaliser la configuration de la source > Paramètres de lecture de la source.

  4. Dans les sections Nombre maximal de connexions simultanées de vidage complet ou Nombre maximal de connexions CDC simultanées, utilisez le champ Personnalisé pour saisir la limite de connexions maximales pour les phases de vidage complet ou de CDC.

  5. Cliquez sur Enregistrer ou Enregistrer et redémarrer.

Ajuster les paramètres de configuration de destination

Vous pouvez personnaliser le délai avant expiration de la transaction et le nombre maximal de connexions simultanées pour votre base de données de destination :

  1. Accédez à la page Jobs de migration de la console Google Cloud .

    Accéder à la page "Jobs de migration"

  2. Cliquez sur le nom à afficher du job de migration que vous souhaitez modifier.

    Une page de présentation s'affiche pour le job de migration.

  3. Développez la section Personnaliser la configuration de la destination et modifiez les paramètres suivants :
    Nombre maximal de connexions de destination simultanées

    Valeur par défaut : 128

    Valeurs autorisées : minimum 2, maximum 256

    Vous pouvez personnaliser le nombre maximal de connexions simultanées que Database Migration Service peut établir avec votre instance de destination.

    Database Migration Service ajuste le nombre de connexions pour garantir les meilleures performances dans la limite de connexions fournie. L'augmentation de la limite maximale de connexions peut améliorer la vitesse de migration, mais introduit une charge supplémentaire sur vos bases de données de destination.

    Délai d'expiration de la transaction

    Valeur par défaut : 30

    Valeurs autorisées : minimum 30, maximum 300

    Lors du processus de migration, Database Migration Service peut rencontrer certains problèmes qui entraînent l'expiration du délai de la transaction. Vous pouvez ajuster le nombre de secondes pendant lesquelles Database Migration Service attend la fin de la transaction avant de l'annuler.

    Les transactions annulées n'entraînent pas l'échec de votre job de migration. La tâche de migration continue de copier les données, mais passe à l'état En cours d'exécution avec des erreurs. Vous pouvez afficher les détails des tâches de migration pour identifier les problèmes à résoudre.

  4. Cliquez sur Enregistrer ou Enregistrer et redémarrer.

Tester une tâche de migration

Avant d'exécuter la tâche de migration, vous pouvez effectuer une opération de test pour vérifier si Database Migration Service peut accéder à toutes les entités sources et de destination nécessaires. Dans la console Google Cloud , vous ne pouvez tester que les tâches de migration brouillon que vous créez dans l'assistant de création de tâches de migration (voir Créer une tâche de migration).

Avec gcloud CLI, vous pouvez tester les tâches de migration qui ont été créées, mais pas encore démarrées.

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

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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 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: 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 du job de migration :