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 les actions suivantes sur les tâches de migration :

Action	Description
Modifier	Vous pouvez modifier les tâches de migration qui ne sont pas à l'état "Brouillon" pour apporter les modifications suivantes : Mettez à jour le nom à afficher de la tâche de migration avec gcloud CLI. Pour en savoir plus, consultez Modifier un job de migration qui n'est pas à l'état "Brouillon". Ajoutez ou supprimez des bases de données de votre job de migration. Pour en savoir plus, consultez Ajouter ou supprimer des bases de données.
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 reprendre, supprimer ou promouvoir un job de migration arrêté.
Reprendre	Si vous arrêtez un job de migration pendant le chargement incrémentiel, vous pouvez le reprendre plus tard. Lorsque vous reprenez un job de migration, Database Migration Service récupère tous les fichiers journaux des 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 poursuivre 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 tâches de migration ayant échoué et ne pouvant pas se remettre de l'erreur réessaient 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 lancé 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	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 l'état de la tâche de migration est différent, vous pouvez choisir de supprimer la paire instance Cloud SQL/primaire de destination.
Promouvoir	Pendant le processus de migration, vos bases de données Cloud SQL pour SQL Server de destination sont mises en mode 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 une tâche de migration ou toutes les bases de données que vous avez sélectionnées pour la 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

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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 :

• Utilisez la commande gcloud database-migration migration-jobs describe pour afficher l'état du job de migration.
• Utilisez gcloud database-migration operations describe avec OPERATION_ID pour afficher l'état de l'opération elle-même.

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

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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 :

• Utilisez la commande gcloud database-migration migration-jobs describe pour afficher l'état du job de migration.
• Utilisez gcloud database-migration operations describe avec OPERATION_ID pour afficher l'état de l'opération elle-même.

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

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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 :

• Utilisez la commande gcloud database-migration migration-jobs describe pour afficher l'état du job de migration.
• Utilisez gcloud database-migration operations describe avec OPERATION_ID pour afficher l'état de l'opération elle-même.

Redémarrer une tâche de migration

Pour redé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. 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 "Redémarrer la tâche de migration" s'affiche.

   • Si vous souhaitez redémarrer uniquement certaines bases de données, sélectionnez-les à l'aide des cases à cocher à côté de leur nom, puis cliquez sur Redémarrer dans l'onglet Bases de données.

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

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

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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 :

• Utilisez la commande gcloud database-migration migration-jobs describe pour afficher l'état du job de migration.
• Utilisez gcloud database-migration operations describe avec OPERATION_ID pour afficher l'état de l'opération elle-même.

Modifier un brouillon de tâche de migration

Pour terminer de créer 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 tâches de migration s'ouvre.

3. Terminez de créer le job de migration. Consultez Créer une tâche 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 les commandes de manière asynchrone. Si c'est le cas, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si votre 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 pour votre job de migration. Cette valeur s'affiche dans la console Google Cloud de Database Migration Service.
• SOURCE_CONNECTION_PROFILE_ID avec un identifiant lisible par machine du profil de connexion source.
• DESTINATION_CONNECTION_PROFILE_ID avec 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 les 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 acceptés, consultez Types de fichiers de sauvegarde acceptés.

• COMMA_SEPARATED_DATABASE_ID_LIST avec une liste d'identifiants de base de données SQL Server séparés par des virgules, à partir desquels vous souhaitez migrer vos fichiers de sauvegarde.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Pour ajouter une base de données à la tâche 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 les 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 des détails du job de migration s'ouvre.

3. Cliquez sur Modifier.
4. Dans la section Sélectionner les bases de données à migrer, cochez les cases pour sélectionner la nouvelle base de données que vous souhaitez ajouter à la tâche 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 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 les commandes de manière asynchrone. Si c'est le cas, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si votre 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 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é.
• COMMA_SEPARATED_DATABASE_ID_LIST avec une liste d'identifiants de base de données SQL Server séparés par des virgules, à partir desquels vous souhaitez migrer vos fichiers de sauvegarde. Ces identifiants doivent être identiques aux noms des dossiers de base de données dans Cloud Storage.

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

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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 tâches de migration non brouillon, vous pouvez utiliser Google Cloud CLI pour modifier le nom à afficher de la tâche 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 les commandes de manière asynchrone. Si c'est le cas, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si votre 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 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é.
• MIGRATION_JOB_NAME par un nom lisible pour votre job de migration. Cette valeur s'affiche dans la console Google Cloud de Database Migration Service.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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 :

• Utilisez la commande gcloud database-migration migration-jobs describe pour afficher l'état du job de migration.
• Utilisez gcloud database-migration operations describe avec OPERATION_ID pour afficher l'état de l'opération elle-même.

Afficher les détails de la migration pour 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 des informations sur 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 les commandes de manière asynchrone. Si c'est le cas, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si votre 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 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é.
• DATABASE_NAME par le nom de la base de données.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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 votre opération a réussi, vous pouvez interroger l'objet d'opération renvoyé ou vérifier l'état du job de migration :

• Utilisez la commande gcloud database-migration migration-jobs describe pour afficher l'état du job de migration.
• Utilisez gcloud database-migration operations describe avec OPERATION_ID pour afficher l'état de l'opération elle-même.

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 informations à leur sujet.

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 les commandes de manière asynchrone. Si c'est le cas, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si votre 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 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

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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 votre opération a réussi, vous pouvez interroger l'objet d'opération renvoyé ou vérifier l'état du job de migration :

• Utilisez la commande gcloud database-migration migration-jobs describe pour afficher l'état du job de migration.
• Utilisez gcloud database-migration operations describe avec OPERATION_ID pour afficher l'état de l'opération elle-même.