Afficher et gérer la progression de la migration

Pour les migrations hétérogènes d'Oracle vers Cloud SQL pour PostgreSQL, vous pouvez surveiller et gérer la progression de la migration pour l'ensemble du job de migration ou pour des tables individuelles incluses dans le job de migration.

Cette page décrit les actions que vous pouvez effectuer à chaque niveau. Pour en savoir plus, consultez les sections Gérer les jobs de migration et Gérer des tables individuelles.

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 l'une des actions suivantes sur votre job de migration :

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

Pour les migrations continues : dans certains cas, la base de données source doit conserver les données jusqu'à ce que vous repreniez le job de migration. La durée de conservation de la base de données source peut être limitée. Si le job de migration est mis en pause pendant une durée supérieure à la période de conservation, puis qu'il est repris, cela peut entraîner l'échec du job de migration. Si cela se produit, supprimez ou redémarrez le job de migration.

Resume Lorsque vous reprenez un job de migration, Database Migration Service reprend les opérations de déplacement des données :
  • Pour les migrations continues arrêtées pendant la phase CDC, Database Migration Service reprend la réplication des événements de modification qui s'accumulent lorsque le job de migration est arrêté.
  • Pour les jobs de migration arrêtés pendant la phase de vidage complet (migration ponctuelle ou continue), Database Migration Service reprend la copie des données qu'il n'a pas copiées avant l'arrêt de la migration.
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 la raison de son échec :

  • Si la réplication a échoué en raison d'une erreur sur une ou plusieurs tables de la base de données source ou de destination, le redémarrage du job de migration efface toutes les données des tables de la base de données de destination incluses dans le job de migration.
  • Le redémarrage du job de migration n'entraîne pas la réplication par Database Migration Service des nouvelles tables que vous avez créées dans la base de données source. Vous devez d'abord ajouter les tables à l'espace de travail de conversion et convertir leur schéma.
Modifier Consultez Modifier un job de migration.
Supprimer 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 pour PostgreSQL de destination associée.
Promouvoir Pendant le processus de migration, votre base de données de destination est placée dans un état en lecture seule, dans lequel elle est entièrement gérée par Database Migration Service. Lorsque vous souhaitez basculer votre application vers la base de données de destination migrée, la promotion du job de migration met à jour la base de données de destination en une instance répliquée autonome. Consultez Promouvoir une migration.

Examiner une tâche de migration

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

    Accéder à la page "Jobs de migration"

  2. Sélectionnez un job de migration pour afficher sa page d'informations, qui comprend les éléments suivants :
    • Métadonnées du job de migration, telles que le nom à afficher, l'ID, le type de migration, le profil de connexion source, le moteur de base de données source, la destination, la méthode de connectivité, la date et l'heure de création du job de migration, et la durée d'exécution du job de migration.
    • État et sous-état du job de migration, et informations supplémentaires. Différentes actions sont disponibles en fonction de l'état et du sous-état du job de 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. Cette commande renvoie donc 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 :

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. Cette commande renvoie donc 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 :

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. Cette commande renvoie donc 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 :

Redémarrer un job de migration

Lorsque vous redémarrez un job de migration, Database Migration Service efface toutes les données des tables de destination. Vos données sources ne sont pas affectées. Le processus de migration recommence alors, en commençant par l'étape de vidage complet.

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. Cliquez sur Restart (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é.

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. Cette commande renvoie donc 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 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 :

  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.

Modifier un job de migration

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

Ajouter ou supprimer des objets de la migration

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

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

    Accéder à la page "Jobs de migration"

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

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

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

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

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

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

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

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

    Accéder à la page "Jobs de migration"

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

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

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

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

Ajuster les paramètres de configuration de la destination

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

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

    Accéder à la page "Jobs de migration"

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

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

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

    Valeur par défaut : 128.

    Valeurs autorisées : minimum 2, maximum 256

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

    Database Migration Service ajuste le nombre de connexions pour garantir des performances optimales dans la limite de connexion fournie. Augmenter la limite maximale de connexions peut améliorer la vitesse de migration, mais cela augmente la charge sur vos bases de données de destination.

    Délai d'expiration de la transaction

    Valeur par défaut : 30.

    Valeurs autorisées : minimum 30, maximum 300

    Pendant le processus de migration, Database Migration Service peut rencontrer certains problèmes qui entraînent l'expiration de la transaction. Vous pouvez ajuster le nombre de secondes pendant lesquelles Database Migration Service attend que la transaction se termine avant d'être annulée.

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

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

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

Gérer des tables individuelles

Pour les migrations hétérogènes d'Oracle vers Cloud SQL pour PostgreSQL, vous pouvez afficher les détails de l'état de tables spécifiques incluses dans votre job de migration.

Afficher toutes les tables d'un job

Pour afficher les détails de toutes les tables 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 Jobs, cliquez sur le nom à afficher de votre job de migration.

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

  3. Sélectionnez l'onglet Tables et affichez toutes les tables incluses dans votre job. Vous pouvez également utiliser des filtres interactifs pour affiner la liste.

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

Cette commande renvoie l'état, la phase et les détails des erreurs pour toutes les tables incluses dans le job de migration, séparés par des lignes vides. 

SOURCE_OBJECT: {'schema': 'Schema1', 'table': 'MyTable1', 'type': 'TABLE'}
STATE: RUNNING
PHASE: CDC
ERROR: {}

SOURCE_OBJECT: {'schema': 'Production', 'table': 'MyTable2', 'type': 'TABLE'}
STATE: RUNNING
PHASE: FULL_DUMP
ERROR:
  { 'code': 2,
    'details': [
        { '@type': 'type.googleapis.com/google.rpc.ErrorInfo',
          'domain': 'datamigration.googleapis.com',
          'metadata': {
            'errorMessage': '[DATABASE] error trying to write processed rows.
              Line: 2619 Position: 0 Schema: production Table: mytable2',
            'errorScope': 'NON_GLOBAL',
            'objectId': 'Production_MyTable2',
            'projectName': 'PROJECT_ID',
            'resourceName': 'MIGRATION_JOB_ID',
            'severity': 'ERROR'
          },
          'reason': 'DESTINATION_WRITE_ERROR'
        }
      ],
    'message': 'Encountered errors with your migration job table. Check the `details`
                  array for specific information on each issue.'
  }

Afficher les détails d'une seule table

Pour afficher les détails de la migration d'une seule table, 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. Sélectionnez l'onglet Tables, puis cliquez sur la table que vous souhaitez inspecter. Vous pouvez également utiliser des filtres interactifs pour affiner la liste.

    Le panneau latéral des détails de la table s'ouvre.

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é.
  • SCHEMA_NAME par le nom du schéma parent qui contient votre table.
  • TABLE_NAME par le nom de votre table.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud database-migration objects lookup \
  --migration-job=MIGRATION_JOB_ID \
  --region=REGION \
  --schema=SCHEMA_NAME \
  --table=TABLE_NAME

Windows (PowerShell)

gcloud database-migration objects lookup `
  --migration-job=MIGRATION_JOB_ID `
  --region=REGION `
  --schema=SCHEMA_NAME `
  --table=TABLE_NAME

Windows (cmd.exe)

gcloud database-migration objects lookup ^
  --migration-job=MIGRATION_JOB_ID ^
  --region=REGION ^
  --schema=SCHEMA_NAME ^
  --table=TABLE_NAME

Résultat

Cette commande renvoie l'état, la phase, l'heure de création et les détails de l'erreur pour votre table. La réponse complète est une chaîne multiligne au format YAML. Exemple : 

createTime: '2025-06-02T10:20:29.792832Z'
error:
  code: 2
  details:
  - '@type': type.googleapis.com/google.rpc.ErrorInfo
    domain: datamigration.googleapis.com
    metadata:
      errorMessage: '[DATABASE] error trying to write processed rows.
              Line: 2619 Position: 0 Schema: production Table: mytable2'
      errorScope: NON_GLOBAL
      objectId: Production_MyTable2
      projectName: PROJECT_ID
      resourceName: MIGRATION_JOB_ID
      severity: ERROR
    reason: DESTINATION_WRITE_ERROR
  message: Encountered errors with your migration job table. Check the `details` array
    for specific information on each issue.
name: projects/PROJECT_ID/locations/REGION/migrationJobs/MIGRATION_JOB_ID/objects/TABLE_UUID
phase: FULL_DUMP
sourceObject:
  schema: Production
  table: MyTable2
  type: TABLE
state: RUNNING