Consulta y administra trabajos de migración

En la consola de Google Cloud , puedes realizar acciones de forma masiva para los trabajos de migración que tienen el mismo estado. Puedes realizar acciones en un solo trabajo de migración tanto en la Google Cloud consola como con Google Cloud CLI.

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

Acción Descripción
Comenzar Iniciar trabajos de migración que no estén en el estado En ejecución o Iniciando Consulta Estados de los trabajos de migración.
Detener Detiene un trabajo de migración en ejecución. Se pausó el movimiento de datos. El estado del trabajo de migración primero cambia a Stopping y, luego, a Stopped. Puedes reanudar, borrar o promocionar un trabajo de migración detenido.

En algunos casos, la base de datos de origen debe conservar los datos hasta que reanudes el trabajo de migración. Es posible que el período de retención de la base de datos de origen sea limitado. Si el trabajo de migración se pausa durante más tiempo que el período de retención y, luego, se reanuda, esto puede provocar que falle. Si esto ocurre, borra o reinicia el trabajo de migración.

Reanudar Puedes reanudar los trabajos de migración que se detuvieron durante la fase de CDC. Cuando reanudas un trabajo de migración, Database Migration Service reanuda la replicación de los eventos de cambio que se acumulan cuando se detiene el trabajo de migración.
Reiniciar Puedes reiniciar un trabajo de migración que tuvo un error y no puede continuar con la replicación de datos. El resultado del reinicio de un trabajo de migración depende del motivo por el que falló:
  • Si la replicación falló debido a un error en una o más tablas de la base de datos de origen o destino, reiniciar el trabajo de migración borrará todos los datos de las tablas de la base de datos de destino incluidas en el trabajo de migración.
  • Si reinicias el trabajo de migración, Database Migration Service no replicará las tablas nuevas que creaste en la base de datos de origen. Primero, debes agregar las tablas al espacio de trabajo de conversión y convertir su esquema.
Editar Consulta Cómo editar un trabajo de migración.
Borrar Se puede borrar un trabajo de migración. El resultado depende del estado del trabajo:
  • Si el trabajo de migración tiene el estado Completed, el registro se borra de la lista de trabajos de migración.
  • Si el trabajo de migración tiene cualquier otro estado, habrá una opción para borrar el clúster de AlloyDB para PostgreSQL de destino asociado.
Promocionar Durante el proceso de migración, tu base de datos de destino se pone en un estado de solo lectura en el que Database Migration Service la administra por completo. Cuando quieras cambiar tu aplicación a la base de datos de destino migrada, la promoción del trabajo de migración actualizará la base de datos de destino a una réplica independiente. Consulta Promueve una migración.

Revisar un trabajo de migración

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

    Ir a Trabajos de migración

  2. Selecciona un trabajo de migración para ver su página de detalles, que incluye lo siguiente:
    • Metadatos del trabajo 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ó el trabajo de migración, y el tiempo que lleva en ejecución.
    • Estado y subestado del trabajo de migración, y otra información. Hay diferentes acciones disponibles según el estado y el subestado del trabajo de migración.

Inicia un trabajo de migración

Cuando el trabajo de migración esté completamente creado (es decir, no se guarde en estado de borrador), podrás iniciarlo en cualquier momento para comenzar a migrar datos.

Para iniciar un trabajo de migración, sigue estos pasos:

Console

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

    Ir a Trabajos de migración

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

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

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

gcloud

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

  • MIGRATION_JOB_ID por el identificador de tu trabajo de migración.

    Si no conoces el identificador, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración en 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 realizó correctamente, puedes consultar el objeto de operación devuelto o verificar el estado del trabajo de migración:

Detén un trabajo de migración

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

Console

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

    Ir a Trabajos de migración

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

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

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

gcloud

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

  • MIGRATION_JOB_ID por el identificador de tu trabajo de migración.

    Si no conoces el identificador, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración en 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 realizó correctamente, puedes consultar el objeto de operación devuelto o verificar el estado del trabajo de migración:

Cómo reanudar un trabajo de migración

Para reanudar un trabajo de migración detenido, sigue estos pasos:

Console

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

    Ir a Trabajos de migración

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

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

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

gcloud

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

  • MIGRATION_JOB_ID por el identificador de tu trabajo de migración.

    Si no conoces el identificador, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración en 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 realizó correctamente, puedes consultar el objeto de operación devuelto o verificar el estado del trabajo de migración:

Cómo reiniciar un trabajo de migración

Para iniciar un trabajo de migración, sigue estos pasos:

Console

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

    Ir a Trabajos de migración

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

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

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

gcloud

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

  • MIGRATION_JOB_ID por el identificador de tu trabajo de migración.

    Si no conoces el identificador, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración en 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: De forma predeterminada, Database Migration Service migra todas las bases de datos de tu origen. Si solo deseas 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 creaste con --database-filter flag usando 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 realizó correctamente, puedes consultar el objeto de operación devuelto o verificar el estado del trabajo de migración:

Actualiza un trabajo de migración de borrador

Para terminar de crear un trabajo de migración, sigue estos pasos:

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

    Ir a Trabajos de migración

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

    Se abrirá el asistente de creación de trabajos de migración.

  3. Finaliza la creación del trabajo de migración. Consulta Crea un trabajo de migración.

Edita un trabajo de migración

Puedes modificar la información de configuración de la fuente, como las tablas y los esquemas de la base de datos en la fuente 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.

Cómo agregar o quitar objetos de la migración

Para agregar o quitar tablas o esquemas de la migración, haz lo siguiente:

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

    Ir a Trabajos de migración

  2. Haz clic en el nombre visible del trabajo de migración que deseas modificar. Aparecerá una página de descripción general del trabajo de migración.

  3. En la sección Selecciona objetos para migrar, selecciona o desmarca las casillas de verificación para cambiar las tablas y los esquemas en el origen que Database Migration Service migrará al destino.

  4. Haz clic en Guardar o 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 comenzará la migración desde el principio, después de limpiar las tablas que selecciones en el destino.

Ajusta las conexiones simultáneas máximas a la base de datos de origen

Puedes personalizar la cantidad máxima de conexiones simultáneas que Database Migration Service puede establecer con tu instancia de origen para la fase de volcado completo o la fase de CDC.

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

    Ir a Trabajos de migración

  2. Haz clic en el nombre visible del trabajo de migración que deseas modificar. Aparecerá una página de descripción general del trabajo de migración.

  3. Expande la sección Personaliza la configuración de la fuente > Configuración de lectura de la fuente.

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

  5. Haz clic en Guardar o Guardar y reiniciar.

Ajusta la configuración de destino

Puedes personalizar el tiempo de espera de la transacción y la cantidad máxima de conexiones simultáneas para tu base de datos de destino:

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

    Ir a Trabajos de migración

  2. Haz clic en el nombre visible del trabajo de migración que deseas modificar.

    Aparecerá una página de descripción general del trabajo de migración.

  3. Expande la sección Personalizar la configuración del destino y modifica los siguientes parámetros de configuración:
    Máximo de conexiones de destino simultáneas

    Valor predeterminado: 128

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

    Puedes personalizar la cantidad máxima de conexiones simultáneas que Database Migration Service puede establecer con tu instancia de destino.

    Database Migration Service ajusta la cantidad de conexiones para garantizar el mejor rendimiento dentro del límite de conexión proporcionado. Aumentar el límite máximo de conexiones puede mejorar la velocidad de migración, pero genera 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, máximo 300

    Durante el proceso de migración, Database Migration Service puede encontrar ciertos problemas que provocan que la transacción agote el tiempo de espera. Puedes ajustar la cantidad de segundos que espera Database Migration Service para que se complete la transacción antes de que se cancele.

    Las transacciones canceladas no provocan que falle tu trabajo de migración. El trabajo de migración continúa copiando datos, pero cambia al estado En ejecución con errores. Puedes ver los detalles del trabajo de migración para verificar qué problemas se deben abordar.

  4. Haz clic en Guardar o Guardar y reiniciar.

Cómo probar un trabajo de migración

Antes de ejecutar el trabajo de migración, puedes realizar una operación de prueba para verificar si Database Migration Service puede acceder a todas las entidades de origen y destino necesarias. En la consola de Google Cloud , solo puedes probar los trabajos de migración en borrador que crees en el asistente para crear trabajos de migración (consulta Cómo crear un trabajo de migración).

Con gcloud CLI, puedes probar los trabajos de migración que se crearon, pero que aún no se iniciaron.

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

  • MIGRATION_JOB_ID por el identificador de tu trabajo de migración.

    Si no conoces el identificador, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración en 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 realizó correctamente, puedes consultar el objeto de operación devuelto o verificar el estado del trabajo de migración: