Afficher et gérer les tâches de migration

Projet: /database-migration/docs/sqlserver-to-csql-pgsql/_project.yaml Livre: /database-migration/docs/sqlserver-to-csql-pgsql/_book.yaml

Dans la console Google Cloud, vous pouvez effectuer des actions groupées pour les tâches de migration ayant le même état. Vous pouvez effectuer des actions sur une seule tâche 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émarrez les tâches de migration qui ne sont pas à l'état En cours d'exécution ou Démarrage. Consultez la section États des tâches de migration.
Arrêter Arrêtez une tâche de migration en cours. Le transfert de données est mis en pause. L'état de la tâche de migration passe d'abord à Stopping, puis à Stopped. Vous pouvez réactiver, supprimer ou promouvoir une tâche de migration arrêtée.

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 durée de conservation de la base de données source peut être limitée. Si la tâche de migration est mise en pause pendant plus de la période de conservation, puis reprise, elle peut échouer. Dans ce cas, supprimez ou redémarrez la tâche de migration.

Réactiver 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 une tâche 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'une tâche 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 de la tâche de migration efface toutes les données des tables de base de données de destination incluses dans la tâche de migration.
  • Redémarrer la tâche de migration ne permet pas à Database Migration Service de répliquer les 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 Une tâche de migration peut être supprimée. Le résultat dépend de l'état de la tâche :
  • Si la tâche de migration est à l'état Completed, l'enregistrement est supprimé de la liste des tâches de migration.
  • Si la tâche 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 entièrement gérée par Database Migration Service. Lorsque vous souhaitez passer à 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 tant que réplica standalone. Consultez la section 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 une tâche de migration pour afficher sa page d'informations, qui comprend les éléments suivants :
    • Métadonnées de la tâche 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 de la tâche de migration, ainsi que la durée de son exécution.
    • É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 de la tâche de migration.

Démarrer une tâche de migration

Une fois votre tâche de migration entièrement créée (c'est-à-dire qu'elle n'est pas enregistrée en tant que brouillon), vous pouvez la démarrer à tout moment pour commencer à migrer les données.

Pour démarrer une tâche 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 (Tâches), cliquez sur le nom à afficher de la tâche de migration que vous souhaitez démarrer.

    La page d'informations sur la tâche 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 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

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

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 (Tâches), cliquez sur le nom à afficher de la tâche de migration que vous souhaitez démarrer.

    La page d'informations sur la tâche 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 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

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 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: 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 de la tâche de migration :

Reprendre une tâche de migration

Pour reprendre une tâche de migration arrêtée, 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 (Tâches), cliquez sur le nom à afficher de la tâche de migration que vous souhaitez démarrer.

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

  3. Cliquez sur Réactiver.
  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 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

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 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: 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 de la tâche de migration :

Redémarrer une tâche de migration

Pour démarrer une tâche 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 (Tâches), cliquez sur le nom à afficher de la tâche de migration que vous souhaitez redémarrer.

    La page d'informations sur la tâche 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 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é.

  • Facultatif: Database Migration Service migre toutes les bases de données de votre source par défaut. Si vous ne souhaitez migrer que 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 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 \
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 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: 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 de la tâche de migration :

Mettre à jour 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 de la tâche de migration que vous souhaitez terminer.

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

  3. Terminez de créer la tâche de migration. Consultez la section Créer une tâche de migration.

Modifier une tâche 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 dans la console Google Cloud.

    Accéder à la page "Jobs de migration"

  2. Cliquez sur le nom à afficher de la tâche de migration que vous souhaitez modifier. Une page d'aperçu de la tâche de migration s'affiche.

  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 sur 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 relance la migration depuis le début, après avoir nettoyé toutes 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 CDC.

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

    Accéder à la page "Jobs de migration"

  2. Cliquez sur le nom à afficher de la tâche de migration que vous souhaitez modifier. Une page d'aperçu de la tâche de migration s'affiche.

  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 de vidage complet simultanées ou Nombre maximal de connexions CDC simultanées, utilisez le champ Personnalisé pour saisir la limite maximale de connexions pour les phases de vidage complet ou de CDC.

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

Ajuster les paramètres de configuration de la 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 dans la console Google Cloud.

    Accéder à la page "Jobs de migration"

  2. Cliquez sur le nom à afficher de la tâche de migration que vous souhaitez modifier.

    Une page d'aperçu de la tâche de migration s'affiche.

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

    Valeur par défaut : 128

    Valeurs autorisées: 2 minimum, 256 maximum

    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 connexion fournie. Augmenter la limite de connexion maximale peut améliorer la vitesse de migration, mais cela entraîne une charge supplémentaire sur vos bases de données de destination.

    Délai avant expiration de la transaction

    Valeur par défaut : 30

    Valeurs autorisées: 30 minimum, 300 maximum

    Au cours du processus de migration, Database Migration Service peut rencontrer certains problèmes qui entraînent l'expiration de la transaction. Vous pouvez ajuster le nombre de secondes pendant lesquelles Database Migration Service attend la fin de la transaction avant qu'elle ne soit annulée.

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

  4. Cliquez sur Enregistrer ou sur 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 atteindre toutes les entités source et de destination nécessaires. Dans la console Google Cloud, vous ne pouvez tester que les tâches de migration 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 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 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

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 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: 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 de la tâche de migration :