Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

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 jobs de migration :

Action	Description
Modifier	Vous pouvez modifier les jobs de migration qui ne sont pas des brouillons pour apporter les modifications suivantes : Mettez à jour le nom à afficher du job de migration avec la gcloud CLI. Pour en savoir plus, consultez Modifier un job de migration qui n'est pas un brouillon. Ajouter ou supprimer des bases de données d'un job de migration qui n'est pas à l'état `Running` (le job doit être à l'état `Not started`, `Stopped` ou `Failed`). Pour en savoir plus, consultez Ajouter ou supprimer des bases de données du job de migration.
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 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 jobs de migration ayant échoué et ne pouvant pas se remettre de l'erreur réessaient l'ensemble du processus de migration, y compris la phase de vidage complet initiale. 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, votre instance Cloud SQL de destination est rétrogradée en réplica en lecture géré 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 la migration. 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 démarrer à tout moment pour commencer la migration des données.

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

Console

Dans la console Google Cloud , accédez à la page Jobs de migration.
Accéder à la page "Jobs de migration"
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.
Cliquez sur Démarrer.
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 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 l'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 avec MIGRATION_JOB_ID pour afficher l'état du job de migration.
Utilisez la commande gcloud database-migration operations describe avec l'option OPERATION_ID pour afficher l'état de l'opération elle-même.

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

Dans la console Google Cloud , accédez à la page Jobs de migration.
Accéder à la page "Jobs de migration"
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.
Cliquez sur Arrêter.
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 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é 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 l'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 un job de migration

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

Console

Dans la console Google Cloud , accédez à la page Jobs de migration.
Accéder à la page "Jobs de migration"
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.
Cliquez sur Réactiver.
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é 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 l'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 un job de migration

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

Console

Dans la console Google Cloud , accédez à la page Jobs de migration.
Accéder à la page "Jobs de migration"
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.
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 indiquant le nombre de bases de données que vous souhaitez redémarrer s'affiche.
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 job de migration 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 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 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 job de migration

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

Console

Dans la console Google Cloud , accédez à la page Jobs de migration.
Accéder à la page "Jobs de migration"
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.
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 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 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 avec un identifiant lisible par machine du profil de connexion de destination.
COMMA_SEPARATED_DATABASE_ID_LIST par une liste d'identifiants de base de données MySQL que vous souhaitez migrer, séparés par une virgule.

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 \
  --databases-filter=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 `
  --databases-filter=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 ^
  --databases-filter=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

Vous pouvez ajouter ou supprimer des bases de données d'un job de migration dans la console Google Cloud ou à l'aide de la Google Cloud CLI, à condition que le job de migration ne soit pas à l'état Running :

Le job de migration doit être à l'état Not started, Stopped ou Failed. Si le job de migration est à l'état Running, vous devez l'arrêter avant de pouvoir modifier la sélection de la base de données.
Important : Si vous ajoutez ou supprimez des bases de données dans un job de migration déjà démarré, Database Migration Service réinitialise la progression de la migration à la phase de vidage complet. Toutes les bases de données sélectionnées pour le job de migration (y compris celles qui ont déjà été migrées) sont supprimées de l'instance Cloud SQL de destination et vidées à nouveau de l'instance source.
Lorsque vous supprimez une base de données d'un job de migration, Database Migration Service cesse de répliquer les modifications apportées à cette base de données, mais ne supprime aucune des données déjà migrées pour cette base de données sur l'instance de destination.

Pour ajouter ou supprimer des bases de données de votre job de migration, procédez comme suit :

Console

Dans la console Google Cloud , accédez à la page Jobs de migration.
Accéder à la page "Jobs de migration"
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.
Si l'état du job de migration est En cours d'exécution, cliquez sur Arrêter, confirmez dans la boîte de dialogue, puis attendez que l'état passe à Arrêté.
Cliquez sur Modifier.
Dans la section Sélectionner les objets à migrer, utilisez le menu Bases de données à migrer pour choisir entre Toutes les bases de données et Bases de données spécifiques. Si vous sélectionnez Bases de données spécifiques, cochez les cases des bases de données que vous souhaitez ajouter ou décochez celles que vous souhaitez supprimer.
Cliquez sur Enregistrer et redémarrer (ou Enregistrer et démarrer si le job n'a pas encore été démarré) pour appliquer vos modifications et exécuter le job de migration, ou cliquez sur Enregistrer.

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 le flag --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 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é.
DATABASE_LIST par une liste de tous les noms de bases de données que vous souhaitez que le job de migration migre (par exemple, my-db-1,my-db-2). Pour que le job de migration migre à nouveau toutes les bases de données de l'instance source, remplacez --databases-filter=DATABASE_LIST par --all-databases.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud database-migration migration-jobs \
update MIGRATION_JOB_ID \
  --region=REGION \
  --databases-filter=DATABASE_LIST

Windows (PowerShell)

gcloud database-migration migration-jobs `
update MIGRATION_JOB_ID `
  --region=REGION `
  --databases-filter=DATABASE_LIST

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
update MIGRATION_JOB_ID ^
  --region=REGION ^
  --databases-filter=DATABASE_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 à l'état de 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 le flag --no-async pour exécuter les 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 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 par l'humain 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

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 accéder à toutes les entités source 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 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é 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 savoir 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 avec MIGRATION_JOB_ID pour afficher l'état du job de migration.
Utilisez la commande 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 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 le flag --no-async pour exécuter les 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 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

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 :

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 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 le flag --no-async pour exécuter les 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 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.

Gérer les tâches de migration Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Démarrer un job de migration

Console

gcloud

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Résultat

Arrêter un job de migration

Console

gcloud

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Résultat

Reprendre un job de migration

Console

gcloud

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Résultat

Redémarrer un job de migration

Console

gcloud

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Résultat

Modifier un brouillon de job de migration

Console

gcloud

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

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

Console

gcloud

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Modifier un job de migration qui n'est pas à l'état de brouillon

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Tester un job de migration

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Résultat

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

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Résultat

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

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Résultat

Gérer les tâches de migration