Ver y gestionar el progreso de la migración

En las migraciones heterogéneas de Oracle a AlloyDB para PostgreSQL, puedes monitorizar y gestionar el progreso de la migración de toda la tarea de migración o de las tablas concretas incluidas en ella.

En esta página se describen las acciones que puedes llevar a cabo en cada nivel. Para obtener más información, consulta las secciones Gestionar trabajos de migración y Gestionar tablas individuales.

Gestionar tareas de migración

En la consola de Google Cloud , puedes realizar acciones en bloque para las tareas de migración que tengan el mismo estado. Puedes realizar acciones en un solo trabajo de migración tanto en la Google Cloud consola como con la CLI de Google Cloud.

Puedes realizar cualquiera de las siguientes acciones en tu trabajo de migración:

Acción	Descripción
Inicio	Iniciar tareas de migración que no estén en el estado En ejecución o Iniciando. Consulta los estados de las tareas de migración.
Detener	Detener una tarea de migración en ejecución. La transferencia de datos se ha pausado. El estado de la tarea de migración cambia primero a Stopping y, después, a Stopped. Puedes reanudar, eliminar o promocionar una tarea de migración detenida. En algunos casos, la base de datos de origen debe conservar los datos hasta que reanudes el trabajo de migración. El periodo de conservación de la base de datos de origen puede ser limitado. Si la tarea de migración se pausa durante un periodo superior al de conservación y, a continuación, se reanuda, puede fallar. Si esto ocurre, elimina o reinicia la tarea de migración.
Currículums	Puedes reanudar las tareas de migración que se hayan detenido durante la fase de CDC. Cuando reanudas una tarea de migración, el servicio de migración de bases de datos reanuda la replicación de los eventos de cambio que se acumulan cuando la tarea de migración está detenida.
Reiniciar	Puedes reiniciar una tarea de migración que haya tenido un error y no pueda continuar con la replicación de datos. El resultado de reiniciar una tarea de migración depende del motivo por el que haya fallado: Si la replicación ha fallado debido a un error en una o varias tablas de la base de datos de origen o de destino, al reiniciar la tarea de migración se borrarán todos los datos de las tablas de la base de datos de destino incluidas en la tarea de migración. Si reinicias la tarea de migración, Database Migration Service no replicará las tablas que hayas creado en la base de datos de origen. Primero debes añadir las tablas al espacio de trabajo de conversión y convertir su esquema.
Editar	Consulta Editar una tarea de migración.
Eliminar	Se puede eliminar una tarea de migración. El resultado depende del estado del trabajo: Si la tarea de migración tiene el estado Completed, el registro se elimina de la lista de tareas de migración. Si el trabajo de migración tiene otro estado, puede eliminar el clúster de destino de AlloyDB para PostgreSQL asociado.
Promocionar	Durante el proceso de migración, la base de datos de destino se pone en un estado de solo lectura en el que Database Migration Service la gestiona por completo. Cuando quieras cambiar tu aplicación a la base de datos de destino migrada, al promover la tarea de migración, la base de datos de destino se actualizará a una réplica independiente. Consulta el artículo Promocionar una migración.

Revisar una tarea de migración

1. En la Google Cloud consola, ve a la página Tareas de migración.

   Ir a Tareas de migración

2. Selecciona un trabajo de migración para ver su página de detalles, que incluye lo siguiente:
   • Metadatos de la tarea de migración, como el nombre visible, el ID, el tipo de migración, el perfil de conexión de origen, el motor de base de datos de origen, el destino, el método de conectividad, la fecha y la hora en que se creó la tarea de migración y el tiempo que lleva en ejecución.
   • Estado y subestado de la tarea de migración, así como información adicional. Hay diferentes acciones disponibles en función del estado y el subestado del trabajo de migración.

Iniciar una tarea de migración

Cuando se haya creado por completo el trabajo de migración (es decir, no se haya guardado en estado de borrador), podrás iniciarlo en cualquier momento para empezar a migrar los datos.

Para iniciar una tarea de migración, siga estos pasos:

Consola

1. En la Google Cloud consola, ve a la página Tareas de migración.

   Ir a Tareas de migración

2. En la pestaña Trabajos, haga clic en el nombre visible del trabajo de migración que quiera iniciar.

   Se abrirá la página de detalles de la tarea de migración.

3. Haz clic en Empezar.
4. En el cuadro de diálogo, haz clic en Iniciar.

gcloud

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

• MIGRATION_JOB_ID con el identificador de tu tarea de migración.

  Si no lo sabes, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración de una región determinada y ver sus identificadores.

• REGION con el identificador de la región en la que se guarda tu perfil de conexión.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Windows (PowerShell)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Resultado

La acción se realiza de forma asíncrona. Por lo tanto, este comando devuelve una entidad Operation que representa una operación de larga duración:

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

Para ver si la operación se ha completado correctamente, puedes consultar el objeto de operación devuelto o comprobar el estado del trabajo de migración:

• Usa el comando gcloud database-migration migration-jobs describe para ver el estado de la tarea de migración.
• Usa gcloud database-migration operations describe con OPERATION_ID para ver el estado de la operación.

Detener una tarea de migración

Puedes detener un trabajo de migración en curso en cualquier momento siguiendo estos pasos:

Consola

1. En la Google Cloud consola, ve a la página Tareas de migración.

   Ir a Tareas de migración

2. En la pestaña Trabajos, haga clic en el nombre visible del trabajo de migración que quiera iniciar.

   Se abrirá la página de detalles de la tarea de migración.

3. Haz clic en Detener.
4. En el cuadro de diálogo, haz clic en Detener.

gcloud

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

• MIGRATION_JOB_ID con el identificador de tu tarea de migración.

  Si no lo sabes, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración de una región determinada y ver sus identificadores.

• REGION con el identificador de la región en la que se guarda tu perfil de conexión.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Windows (PowerShell)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Resultado

La acción se realiza de forma asíncrona. Por lo tanto, este comando devuelve una entidad Operation que representa una operación de larga duración:

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

Para ver si la operación se ha completado correctamente, puedes consultar el objeto de operación devuelto o comprobar el estado del trabajo de migración:

• Usa el comando gcloud database-migration migration-jobs describe para ver el estado de la tarea de migración.
• Usa gcloud database-migration operations describe con OPERATION_ID para ver el estado de la operación.

Reanudar una tarea de migración

Para reanudar una tarea de migración detenida, sigue estos pasos:

Consola

1. En la Google Cloud consola, ve a la página Tareas de migración.

   Ir a Tareas de migración

2. En la pestaña Trabajos, haga clic en el nombre visible del trabajo de migración que quiera iniciar.

   Se abrirá la página de detalles de la tarea de migración.

3. Haz clic en Reanudar.
4. En el cuadro de diálogo, haz clic en Reanudar.

gcloud

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

• MIGRATION_JOB_ID con el identificador de tu tarea de migración.

  Si no lo sabes, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración de una región determinada y ver sus identificadores.

• REGION con el identificador de la región en la que se guarda tu perfil de conexión.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Windows (PowerShell)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Resultado

La acción se realiza de forma asíncrona. Por lo tanto, este comando devuelve una entidad Operation que representa una operación de larga duración:

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

Para ver si la operación se ha completado correctamente, puedes consultar el objeto de operación devuelto o comprobar el estado del trabajo de migración:

• Usa el comando gcloud database-migration migration-jobs describe para ver el estado de la tarea de migración.
• Usa gcloud database-migration operations describe con OPERATION_ID para ver el estado de la operación.

Reiniciar una tarea de migración

Cuando reinicias una tarea de migración, Database Migration Service borra todos los datos de las tablas de destino, pero los datos de origen no se ven afectados. El proceso de migración volverá a empezar, comenzando por la fase de volcado completo.

Para reiniciar una tarea de migración, sigue estos pasos:

Consola

1. En la Google Cloud consola, ve a la página Tareas de migración.

   Ir a Tareas de migración

2. En la pestaña Trabajos, haga clic en el nombre visible del trabajo de migración que quiera reiniciar.

   Se abrirá la página de detalles de la tarea de migración.

3. Haz clic en Reiniciar.
4. En el cuadro de diálogo, haz clic en Reiniciar.

gcloud

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

• MIGRATION_JOB_ID con el identificador de tu tarea de migración.

  Si no lo sabes, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración de una región determinada y ver sus identificadores.

• REGION con el identificador de la región en la que se guarda tu tarea de migración.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Windows (PowerShell)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Resultado

La acción se realiza de forma asíncrona. Por lo tanto, este comando devuelve una entidad Operation que representa una operación de larga duración:

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

Para ver si la operación se ha completado correctamente, puedes consultar el objeto de operación devuelto o comprobar el estado del trabajo de migración:

• Usa el comando gcloud database-migration migration-jobs describe para ver el estado de la tarea de migración.
• Usa gcloud database-migration operations describe con OPERATION_ID para ver el estado de la operación.

Actualizar una tarea de migración en borrador

Para terminar de crear una tarea de migración, sigue estos pasos:

1. En la Google Cloud consola, ve a la página Tareas de migración.

   Ir a Tareas de migración

2. En la pestaña Borradores, haga clic en el nombre visible del trabajo de migración que quiera terminar de crear.

   Se abrirá el asistente para crear tareas de migración.

3. Termina de crear la tarea de migración. Consulta el artículo Crear una tarea de migración.

Editar una tarea de migración

Puede modificar la información de configuración de la fuente, como las tablas y los esquemas de la base de datos de origen que Database Migration Service migrará al destino. Database Migration Service usa esta información de configuración para migrar los datos correctos del origen al destino.

Añadir o quitar objetos de la migración

Para añadir o quitar tablas o esquemas de la migración, sigue estos pasos:

1. Ve a la página Tareas de migración de la Google Cloud consola.

   Ir a Tareas de migración

2. Haga clic en el nombre visible del trabajo de migración que quiera modificar. Aparecerá una página de resumen de la tarea de migración.

3. En la sección Seleccionar objetos que se van a migrar, marque o desmarque las casillas para cambiar las tablas y los esquemas de la fuente que Database Migration Service migrará al destino.

   Asegúrate de que el destino tenga los esquemas que selecciones.

4. Haga clic en Guardar o en Guardar y reiniciar.

   • Si haces clic en Guardar, Database Migration Service solo moverá los datos históricos de los esquemas y las tablas que selecciones.

   • Si haces clic en Guardar y reiniciar, Database Migration Service iniciará la migración desde el principio después de limpiar las tablas que selecciones en el destino.

Ajustar el número máximo de conexiones simultáneas a la base de datos de origen

Puedes personalizar el número máximo de conexiones simultáneas que el servicio de migración de bases de datos puede establecer con tu instancia de origen durante la fase de volcado completo o la fase de CDC.

1. Ve a la página Tareas de migración de la Google Cloud consola.

   Ir a Tareas de migración

2. Haga clic en el nombre visible del trabajo de migración que quiera modificar. Aparecerá una página de resumen de la tarea de migración.

3. Despliega la sección Personalizar configuración de la fuente > Ajustes de lectura de la fuente.

4. En las secciones Número máximo de conexiones simultáneas de volcado completo o Número máximo de conexiones simultáneas de CDC, usa el campo Personalizado para introducir el límite máximo de conexiones de las fases de volcado completo o de CDC.

5. Haga clic en Guardar o en Guardar y reiniciar.

Ajustar la configuración de destino

Puedes personalizar el tiempo de espera de las transacciones y el número máximo de conexiones simultáneas de tu base de datos de destino:

1. Ve a la página Tareas de migración de la Google Cloud consola.

   Ir a Tareas de migración

2. Haga clic en el nombre visible del trabajo de migración que quiera modificar.

   Aparecerá una página de resumen de la tarea de migración.

3. Despliega la sección Personalizar configuración de destino y modifica los siguientes ajustes:

   Número máximo de conexiones simultáneas de destino

   Valor predeterminado: 128

   Valores permitidos: mínimo 2 y máximo 256

   Puedes personalizar el número máximo de conexiones simultáneas que el servicio de migración de bases de datos puede establecer con tu instancia de destino.

   Database Migration Service ajusta el número de conexiones para asegurar el mejor rendimiento posible dentro del límite de conexiones proporcionado. Aumentar el límite máximo de conexiones puede mejorar la velocidad de migración, pero introduce una carga adicional en las bases de datos de destino.

   Tiempo de espera de la transacción

   Valor predeterminado: 30

   Valores permitidos: mínimo 30 y máximo 300

   Durante el proceso de migración, Database Migration Service puede encontrar ciertos problemas que provoquen que la transacción agote el tiempo de espera. Puedes ajustar el número de segundos que espera el servicio de migración de bases de datos para que se complete la transacción antes de que se cancele.

   Las transacciones canceladas no provocan que falle la tarea de migración. La tarea de migración sigue copiando datos, pero pasa al estado En ejecución con errores. Puede ver los detalles de la tarea de migración para comprobar qué problemas debe solucionar.

4. Haga clic en Guardar o en Guardar y reiniciar.

Probar una tarea de migración

Antes de ejecutar la tarea de migración, puedes realizar una operación de prueba para comprobar si Database Migration Service puede acceder a todas las entidades de origen y destino necesarias. En la Google Cloud consola, solo puedes probar las tareas de migración en borrador que crees en el asistente de creación de tareas de migración (consulta Crear una tarea de migración).

Con la CLI de gcloud, puedes probar las tareas de migración que se han creado, pero que aún no se han iniciado.

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

• MIGRATION_JOB_ID con el identificador de tu tarea de migración.

  Si no lo sabes, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración de una región determinada y ver sus identificadores.

• REGION con el identificador de la región en la que se guarda tu perfil de conexión.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Windows (PowerShell)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Resultado

La acción se realiza de forma asíncrona. Por lo tanto, este comando devuelve una entidad Operation que representa una operación de larga duración:

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

Para ver si la operación se ha completado correctamente, puedes consultar el objeto de operación devuelto o comprobar el estado del trabajo de migración:

• Usa el comando gcloud database-migration migration-jobs describe para ver el estado de la tarea de migración.
• Usa gcloud database-migration operations describe con OPERATION_ID para ver el estado de la operación.

Gestionar tablas concretas

En las migraciones heterogéneas de Oracle a AlloyDB para PostgreSQL, puede ver los detalles del estado de tablas específicas incluidas en su tarea de migración.

Ver todas las tablas de un trabajo

Para ver los detalles de todas las tablas de un trabajo de migración, siga estos pasos:

Consola

1. En la Google Cloud consola, ve a la página Tareas de migración.

   Ir a Tareas de migración

2. En la pestaña Tareas, haz clic en el nombre visible de la tarea de migración.

   Se abrirá la página de detalles de la tarea de migración.

3. Selecciona la pestaña Tablas para ver todas las tablas incluidas en tu trabajo. También puedes usar filtros interactivos para acotar la lista.

gcloud

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

• MIGRATION_JOB_ID con el identificador de tu tarea de migración.

  Si no lo sabes, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración de una región determinada y ver sus identificadores.

• REGION con el identificador de la región en la que se guarda tu tarea de migración.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Windows (PowerShell)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Resultado

Este comando devuelve el estado, la fase y los detalles de los errores de todas las tablas incluidas en la tarea de migración, separados por líneas vacías.

Nota: En el siguiente ejemplo se añade una sangría para que sea más fácil de ver, pero ten en cuenta que el objeto ERROR de la respuesta es una cadena de una sola línea con formato JSON que contiene todos los problemas del objeto específico.

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.'
  }

Ver los detalles de una sola tabla

Para ver los detalles de la migración de una sola tabla, sigue estos pasos:

Consola

1. En la Google Cloud consola, ve a la página Tareas de migración.

   Ir a Tareas de migración

2. En la pestaña Tareas, haz clic en el nombre visible de la tarea de migración.

   Se abrirá la página de detalles de la tarea de migración.

3. Selecciona la pestaña Tablas y haz clic en la tabla que quieras inspeccionar. También puedes usar filtros interactivos para acotar la lista.

   Se abrirá el panel lateral de detalles de la tabla.

gcloud

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

• MIGRATION_JOB_ID con el identificador de tu tarea de migración.

  Si no lo sabes, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración de una región determinada y ver sus identificadores.

• REGION con el identificador de la región en la que se guarda tu tarea de migración.
• SCHEMA_NAME con el nombre del esquema principal que contiene la tabla.
• TABLE_NAME con el nombre de la tabla.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Windows (PowerShell)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

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

Resultado

Este comando devuelve el estado, la fase, la hora de creación y los detalles del error de la tabla. Toda la respuesta es una cadena multilínea con formato YAML. Por ejemplo:

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