Gérer les tâches de migration

Dans la console Google Cloud , vous pouvez effectuer des actions de manière groupée pour les jobs de migration ayant le même état. Vous pouvez effectuer des actions sur un job de migration unique dans la console Google Cloud (depuis la console Database Migration Service ou directement depuis la page de l'instance Cloud SQL de destination) et à l'aide de la Google Cloud CLI.

Vous pouvez effectuer les actions suivantes sur les jobs de migration :

Action Description
Modifier

Vous pouvez modifier les jobs de migration qui ne sont pas des brouillons pour apporter les modifications suivantes :
Démarrer Démarrez les jobs 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 un job de migration en cours d'exécution. Le déplacement des données est suspendu. L'état du job de migration passe d'abord à Stopping, puis à Stopped. Vous pouvez reprendre, supprimer ou promouvoir un job de migration arrêté.
Resume Si vous arrêtez un job de migration pendant le chargement incrémentiel, vous pouvez le reprendre ultérieurement. Lorsque vous reprenez un job de migration, Database Migration Service récupère tous les fichiers journaux de transactions 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 procéder à la réplication des données.

Le résultat du redémarrage d'un job de migration dépend de l'une des raisons suivantes pour lesquelles il a échoué :

  • Les jobs de migration ayant échoué et ne pouvant pas récupérer après l'erreur relancent l'ensemble du processus de migration, y compris le chargement initial du fichier de sauvegarde complet.
  • Si la réplication a échoué en raison d'une erreur sur une ou plusieurs bases de données sources ou de destination, le redémarrage de la migration efface toutes les données des bases de données de destination.
  • Si vous créez un dossier pour une autre base de données après avoir démarré la migration et que vous l' ajoutez aux bases de données sélectionnées pour la migration, le redémarrage de la migration réplique également les nouvelles bases de données dans l'instance de destination.
Supprimer Un job de migration peut être supprimé. Le résultat dépend de l'état du job :
  • Si le job de migration est à l'état Completed, l'enregistrement est supprimé de la liste des jobs de migration.
  • Si le job de migration est dans un autre état, vous pouvez choisir de supprimer l'instance Cloud SQL de destination ou la paire principale.
Promouvoir Pendant le processus de migration, vos bases de données Cloud SQL pour SQL Server de destination sont placées en mode de récupération, où elles sont entièrement gérées par Database Migration Service. Vous ne pouvez effectuer aucune opération de lecture ou d'écriture sur les bases de données de destination tant que vous n'avez pas promu le job de migration ou les bases de données sélectionnées. Pour en savoir plus, consultez Promouvoir une migration.
Afficher Vous pouvez afficher les détails d'une base de données spécifique dans un job de migration ou toutes les bases de données que vous avez sélectionnées pour la migration.

Démarrer un job 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 lancer à tout moment pour commencer à migrer des données.

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

Console

Vous pouvez démarrer un job de migration depuis la console Database Migration Service ou depuis la page de l'instance de destination.

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

    La page d'informations sur le job de migration s'ouvre.

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

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 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 d'une région donnée et afficher leurs identifiants.

  • REGION par l'identifiant de la région dans laquelle votre job de migration 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é 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 :

Arrêter un job de migration

Vous pouvez arrêter un job de migration en cours d'exécution à tout moment en procédant comme suit :

Console

Vous pouvez arrêter un job de migration depuis la console Database Migration Service ou depuis la page de l'instance de destination.

Depuis la console 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 arrêter.

    La page d'informations sur le job de migration s'ouvre.

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

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 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 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 \
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é 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: stop
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 :

Reprendre un job de migration

Pour reprendre un job de migration arrêté, procédez comme suit :

Console

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

Depuis la console 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 reprendre.

    La page d'informations sur le job de migration s'ouvre.

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

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 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 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 \
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é 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: resume
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 :

Redémarrer un job de migration

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

Console

Vous pouvez redémarrer un job de migration depuis la console Database Migration Service ou depuis la page de l'instance de destination.

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

    La page d'informations sur le job de migration s'ouvre.

  3. Effectuez l'une des actions de redémarrage suivantes :

    • Si vous souhaitez redémarrer toutes les bases de données incluses dans la migration, cliquez sur Redémarrer dans la barre d'outils du job de migration.

      La boîte de dialogue de redémarrage du job de migration s'affiche.

    • Si vous ne souhaitez redémarrer que certaines bases de données, sélectionnez-les à l'aide des cases à cocher situées à côté de leur nom, puis cliquez sur Redémarrer 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 redémarrer.

  4. Dans la boîte de dialogue, cliquez sur Redémarrer.

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 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 d'une région donnée et afficher leurs identifiants.

  • REGION par l'identifiant de la région dans laquelle votre job de migration 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 \
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é 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: restart
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 :

Mettre à jour un brouillon de job de migration

Pour terminer la création d'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 Brouillons, cliquez sur le nom à afficher du job de migration que vous souhaitez terminer de créer.

    L'assistant de création de job de migration s'ouvre.

  3. Terminez la création du job de migration. Consultez Créer un job de migration.

gcloud

Cet exemple utilise l'option facultative --no-async pour que toutes les opérations soient effectuées de manière synchrone. Cela signifie que l'exécution de certaines commandes peut prendre un certain temps. Vous pouvez ignorer l'option --no-async pour exécuter des commandes de manière asynchrone. Si vous le faites, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si l'opération a réussi.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • MIGRATION_JOB_ID par un identifiant lisible par machine pour votre job de migration.
  • REGION par l'identifiant de la région dans laquelle vous souhaitez enregistrer le profil de connexion.
  • MIGRATION_JOB_NAME par un nom lisible par l'humain pour votre job de migration. Cette valeur s'affiche dans Database Migration Service dans la console Google Cloud .
  • SOURCE_CONNECTION_PROFILE_ID par un identifiant lisible par machine du profil de connexion source.
  • DESTINATION_CONNECTION_PROFILE_ID par un identifiant lisible par machine du profil de connexion de destination.
  • Configuration de la sauvegarde différentielle : vous pouvez configurer si le job de migration peut utiliser des fichiers de sauvegarde différentielle du bucket Cloud Storage. Ajoutez l'un des indicateurs suivants à votre commande :
    • --sqlserver-diff-backup pour activer les fichiers de sauvegarde différentielle pour votre migration
    • --no-sqlserver-diff-backup pour désactiver les fichiers de sauvegarde différentielle pour votre migration

    Pour en savoir plus sur les fichiers de sauvegarde compatibles, consultez Types de fichiers de sauvegarde compatibles.

  • COMMA_SEPARATED_DATABASE_ID_LIST par une liste d'identifiants de base de données SQL Server séparés par une virgule que vous souhaitez migrer à partir de vos fichiers de sauvegarde.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud database-migration migration-jobs \
create MIGRATION_JOB_ID \
  --no-async \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME \
  --source=SOURCE_CONNECTION_PROFILE_ID \
  --destination=DESTINATION_CONNECTION_PROFILE_ID \
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST \
  --type=CONTINUOUS

Windows (PowerShell)

gcloud database-migration migration-jobs `
create MIGRATION_JOB_ID `
  --no-async `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME `
  --source=SOURCE_CONNECTION_PROFILE_ID `
  --destination=DESTINATION_CONNECTION_PROFILE_ID `
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST `
  --type=CONTINUOUS

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
create MIGRATION_JOB_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME ^
  --source=SOURCE_CONNECTION_PROFILE_ID ^
  --destination=DESTINATION_CONNECTION_PROFILE_ID ^
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST ^
  --type=CONTINUOUS

Vous devriez obtenir un résultat semblable à celui-ci :

Waiting for migration job [MIGRATION_JOB_ID]
to be updated with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

Ajouter ou supprimer des bases de données du job de migration

Pour ajouter une base de données au job de migration, vous devez d'abord créer un dossier dédié dans votre bucket Cloud Storage et y importer les fichiers de sauvegarde. Consultez Configurer des buckets Cloud Storage.

Une fois que vous disposez des fichiers de sauvegarde nécessaires dans le bucket Cloud Storage, 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 de votre job de migration.

    La page d'informations sur le job de migration s'ouvre.

  3. Cliquez sur Modifier.
  4. Dans la section Sélectionner les bases de données à migrer, cochez les cases correspondant aux nouvelles bases de données que vous souhaitez ajouter au job de migration ou décochez celles que vous souhaitez supprimer.
  5. (Facultatif) Si vous utilisez des sauvegardes chiffrées, fournissez les clés de chiffrement de vos sauvegardes. Pour en savoir plus sur l'utilisation des sauvegardes chiffrées, consultez Utiliser des sauvegardes chiffrées.

    Effectuez les actions suivantes :

    • Cliquez sur Modifier les détails à côté de la base de données que vous avez sélectionnée pour la migration.

      Le panneau latéral Chiffrement s'ouvre.

    • Utilisez les menus Clé de chiffrement pour sélectionner vos clés.
    • Dans le champ Password (Mot de passe), saisissez le mot de passe de la clé de chiffrement.
    • Cliquez sur Enregistrer et quitter.

gcloud

Cet exemple utilise l'option facultative --no-async pour que toutes les opérations soient effectuées de manière synchrone. Cela signifie que l'exécution de certaines commandes peut prendre un certain temps. Vous pouvez ignorer l'option --no-async pour exécuter des commandes de manière asynchrone. Si vous le faites, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si l'opération a réussi.

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é.
  • COMMA_SEPARATED_DATABASE_ID_LIST par une liste d'identifiants de base de données SQL Server séparés par une virgule que vous souhaitez migrer à partir de vos fichiers de sauvegarde. Ces identifiants doivent être identiques aux noms des dossiers de base de données dans votre bucket Cloud Storage.

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

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud database-migration migration-jobs \
update MIGRATION_JOB_ID \
  --region=REGION \
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

Windows (PowerShell)

gcloud database-migration migration-jobs `
update MIGRATION_JOB_ID `
  --region=REGION `
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
update MIGRATION_JOB_ID ^
  --region=REGION ^
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

Vous devriez obtenir un résultat semblable à celui-ci :

Waiting for migration job [MIGRATION_JOB_ID]
to be updated with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

Modifier un job de migration qui n'est pas un brouillon

Pour les jobs de migration qui ne sont pas à l'état de brouillon, vous pouvez utiliser la Google Cloud CLI pour modifier le nom à afficher du job de migration :

Cet exemple utilise l'option facultative --no-async pour que toutes les opérations soient effectuées de manière synchrone. Cela signifie que l'exécution de certaines commandes peut prendre un certain temps. Vous pouvez ignorer l'option --no-async pour exécuter des commandes de manière asynchrone. Si vous le faites, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si l'opération a réussi.

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é.
  • MIGRATION_JOB_NAME par un nom lisible par l'humain pour votre job de migration. Cette valeur s'affiche dans Database Migration Service dans la console Google Cloud .

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud database-migration migration-jobs \
update MIGRATION_JOB_ID \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME

Windows (PowerShell)

gcloud database-migration migration-jobs `
update MIGRATION_JOB_ID `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
update MIGRATION_JOB_ID ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME

Vous devriez obtenir un résultat semblable à celui-ci :

Waiting for migration job [MIGRATION_JOB_ID]
to be updated with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

Tester un job de migration

Avant d'exécuter le job de migration, vous pouvez effectuer une opération de test pour vérifier si Database Migration Service peut atteindre toutes les entités sources et de destination nécessaires. Dans la console Google Cloud , vous ne pouvez tester que les brouillons de jobs de migration que vous créez dans l'assistant de création de jobs de migration (voir Créer un job de migration).

Avec gcloud CLI, vous pouvez tester les jobs de migration créés, mais pas encore démarrés.

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 \
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é 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: verify
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 :

Afficher les détails de la migration d'une base de données spécifique

Une fois votre job de migration entièrement créé (c'est-à-dire qu'il n'est pas enregistré à l'état de brouillon), vous pouvez utiliser la Google Cloud CLI pour afficher les détails d'une base de données spécifique dans ce job de migration.

Cet exemple utilise l'option facultative --no-async pour que toutes les opérations soient effectuées de manière synchrone. Cela signifie que l'exécution de certaines commandes peut prendre un certain temps. Vous pouvez ignorer l'option --no-async pour exécuter des commandes de manière asynchrone. Si vous le faites, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si l'opération a réussi.

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é.
  • DATABASE_NAME par le nom de la base de données.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID \
  --region=REGION --database=DATABASE_NAME

Windows (PowerShell)

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID `
  --region=REGION --database=DATABASE_NAME

Windows (cmd.exe)

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID ^
  --region=REGION --database=DATABASE_NAME

Résultat

Le résultat ressemble à ce qui suit : 

createTime: '2025-03-21T17:05:19.211441641Z'
name: PROJECT_ID
phase: FULL_DUMP
sourceObject:
  database: DATABASE_NAME
  type: DATABASE
state: RUNNING
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 :

Afficher les détails de la migration pour des bases de données spécifiques

Une fois votre job de migration entièrement créé (c'est-à-dire qu'il n'est pas enregistré à l'état de brouillon), vous pouvez utiliser la Google Cloud CLI pour lister toutes les bases de données que vous avez sélectionnées pour ce job de migration et afficher des détails les concernant.

Cet exemple utilise l'option facultative --no-async pour que toutes les opérations soient effectuées de manière synchrone. Cela signifie que l'exécution de certaines commandes peut prendre un certain temps. Vous pouvez ignorer l'option --no-async pour exécuter des commandes de manière asynchrone. Si vous le faites, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si l'opération a réussi.

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 objects list --migration-job=MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

gcloud database-migration objects list --migration-job=MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

gcloud database-migration objects list --migration-job=MIGRATION_JOB_ID ^
  --region=REGION

Résultat

Le résultat ressemble à ce qui suit : 

Waiting for migration job MIGRATION_JOB_ID
to fetch source objects with OPERATION_ID

Waiting for operation OPERATION_ID to complete...done.

SOURCE_OBJECT                            STATE    PHASE      ERROR
{'database': 'db1', 'type': 'DATABASE'}  RUNNING  FULL_DUMP
{'database': 'db2', 'type': 'DATABASE'}  STOPPED  CDC        {'code': 1, 'message': 'Internal error'}
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 :