Consulta y administra trabajos de migración

Proyecto: /database-migration/docs/sqlserver-to-csql-pgsql/_project.yaml Libro: /database-migration/docs/sqlserver-to-csql-pgsql/_book.yaml

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

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

Acción Descripción
Comenzar Inicia los trabajos de migración que no estén en los estados Running o Starting. Consulta Estados de los trabajos de migración.
Detener Detener un trabajo de migración en ejecución Se pausa 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 retener 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, es posible que falle. Si esto ocurre, borra o reinicia el trabajo de migración.

Reanudar Puedes reanudar los trabajos de migración detenidos 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 encontró un error y no puede continuar con la replicación de datos. El resultado de reiniciar un trabajo de migración depende del motivo del error:
  • 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.
  • Reiniciar el trabajo de migración no hace que Database Migration Service replique las tablas nuevas que creaste en la base de datos de origen. Primero, debes agregar las tablas al lugar de trabajo de conversiones 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, hay una opción para borrar la instancia de Cloud SQL de destino asociada.
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 actualiza la base de datos de destino a una réplica independiente. Consulta Cómo ascender 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.

    Ve 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 durante cuánto tiempo se ejecuta
    • Estado y subestado del trabajo de migración, y otra información Existen diferentes acciones disponibles según el estado y el subestado del trabajo de migración.

Cómo iniciar un trabajo de migración

Cuando tu trabajo de migración se haya creado por completo (es decir, no se haya guardado en un estado de borrador), podrás iniciarlo en cualquier momento para comenzar a migrar los 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.

    Ve 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 todas las tareas de migración en una región determinada y ver sus identificadores.

  • REGION por 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 muestra una entidad de operación 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 que se muestra o verificar el estado de la tarea de migración:

Detén un trabajo de migración

Puedes detener una tarea de migración en ejecución en cualquier momento. Para ello, sigue estos pasos:

Console

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

    Ve 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 cuadro de 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 todas las tareas de migración en una región determinada y ver sus identificadores.

  • REGION por 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 muestra una entidad de operación 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 que se muestra o verificar el estado de la tarea 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.

    Ve 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 todas las tareas de migración en una región determinada y ver sus identificadores.

  • REGION por 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 muestra una entidad de operación 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 que se muestra o verificar el estado de la tarea de migración:

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

    Ve 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 todas las tareas de migración en una región determinada y ver sus identificadores.

  • REGION por 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 fuente de forma predeterminada. Si deseas migrar solo 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 las tareas de migración que creaste con --database-filter flag con 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 muestra una entidad de operación 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 que se muestra o verificar el estado de la tarea de migración:

Actualiza un borrador de trabajo de migración

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.

    Ve a Trabajos de migración

  2. En la pestaña Borradores, haz clic en el nombre visible de la tarea 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 de la fuente que Database Migration Service migrará al destino. Database Migration Service usa esta información de configuración para migrar los datos correctos de la fuente 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 consola de Google Cloud.

    Ve 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 de la fuente 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.

Cómo ajustar la cantidad máxima de conexiones simultáneas 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 Google Cloud Console.

    Ve 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 Customize source configuration > Source read settings.

  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.

Cómo ajustar 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 consola de Google Cloud.

    Ve 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 Customize destination configuration 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 puede realizar Database Migration Service a tu instancia de destino.

    Database Migration Service ajusta la cantidad de conexiones para garantizar el mejor rendimiento 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, máximo 300

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

    Las transacciones canceladas no hacen que falle tu trabajo de migración. El trabajo de migración sigue copiando datos, pero cambia al estado Running with errors. 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.

Prueba 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 llegar a todas las entidades de origen y destino necesarias. En la consola de Google Cloud, solo puedes probar los borradores de trabajos de migración que creas en el asistente para crear trabajos de migración (consulta Cómo crear un trabajo de migración).

Con gcloud CLI, puedes probar 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 todas las tareas de migración en una región determinada y ver sus identificadores.

  • REGION por 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 muestra una entidad de operación 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 que se muestra o verificar el estado de la tarea de migración: