Ver y 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 la tarea de migración tiene otro estado, puede eliminar la instancia de Cloud SQL de destino asociada.
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 el trabajo de migración se haya creado por completo (es decir, no se haya guardado en estado de borrador), podrás iniciarlo en cualquier momento para empezar a migrar 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 conoce, puede 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

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

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:

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 conoce, puede 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

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

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:

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 conoce, puede 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

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

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:

Reiniciar una tarea de migración

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 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 conoce, puede 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.

  • Opcional: Database Migration Service migra todas las bases de datos de tu origen de forma predeterminada. Si solo quieres migrar bases de datos específicas, usa la marca --databases-filter y especifica sus identificadores como una lista separada por comas.

    Por ejemplo: --databases-filter=my-business-database,my-other-database

    Más adelante, puedes editar los trabajos de migración que hayas creado con --database-filter flag mediante el comando gcloud database-migration migration-jobs update.

Ejecuta el siguiente comando:

Linux, macOS o 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

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:

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 migrar, marque o desmarque las casillas para cambiar las tablas y los esquemas de la fuente que Database Migration Service migrará al destino.

  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 conoce, puede 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

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

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: