Administrar trabajos de migración

En la consola de Google Cloud , puedes realizar acciones masivas 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 y 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.
Reanudar Si detienes un trabajo de migración durante la carga incremental, puedes reanudarlo más tarde. Cuando reanudas un trabajo de migración, Database Migration Service recupera todos los archivos de registro de transacciones 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 por el que falló:
  • Los trabajos de migración que fallan y no pueden recuperarse del error vuelven a intentar todo el proceso de migración, incluida la carga inicial del archivo de copia de seguridad completa.
  • Si la replicación falló debido a un error en una o más bases de datos de origen o de destino, reiniciar la migración borrará todos los datos de las bases de datos de destino.
  • Si creas una carpeta nueva para otra base de datos después de iniciar la migración y la agregas a las bases de datos seleccionadas para la migración, reiniciar la migración también replica las bases de datos nuevas en la instancia de destino.
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 algún otro estado, hay una opción para borrar la instancia de Cloud SQL de destino o el par principal.
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, si promocionas el trabajo de migración, esta se actualizará a una réplica independiente.
Durante el proceso de migración, tus bases de datos de Cloud SQL para SQL Server de destino se ponen en modo de recuperación, en el que Database Migration Service las administra por completo. No puedes realizar ninguna operación de lectura o escritura en las bases de datos de destino hasta que promociones el trabajo de migración. Consulta Cómo ascender una 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.

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:

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

gcloud

En este ejemplo, se usa la marca opcional --no-async para que todas las operaciones se realicen de forma síncrona. Esto significa que algunos comandos pueden tardar un poco en completarse. Puedes omitir la marca --no-async para ejecutar comandos de forma asíncrona. Si es así, debes usar el comando gcloud database-migration operations describe para verificar si la operación se realizó correctamente.

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

  • MIGRATION_JOB_ID con un identificador legible por máquinas para tu trabajo de migración.
  • REGION con el identificador de región en el que deseas guardar el perfil de conexión.
  • MIGRATION_JOB_NAME por un nombre legible para tu trabajo de migración. Este valor se muestra en Database Migration Service en la consola de Google Cloud .
  • SOURCE_CONNECTION_PROFILE_ID con un identificador legible por máquinas del perfil de conexión de origen.
  • DESTINATION_CONNECTION_PROFILE_ID con un identificador legible por máquina del perfil de conexión de destino.
  • Configuración de la copia de seguridad diferencial: Puedes configurar si el trabajo de migración puede usar archivos de copia de seguridad diferenciales del bucket de Cloud Storage. Agrega una de las siguientes marcas a tu comando:
    • --sqlserver-diff-backup para habilitar los archivos de copia de seguridad diferenciales para tu migración
    • --no-sqlserver-diff-backup para inhabilitar los archivos de copia de seguridad diferenciales para tu migración

    Para obtener más información sobre los archivos de copia de seguridad compatibles, consulta Tipos de archivos de copia de seguridad compatibles.

  • COMMA_SEPARATED_DATABASE_ID_LIST con una lista de identificadores de bases de datos del servidor SQL que deseas migrar desde tus archivos de copia de seguridad, separados por comas

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud database-migration migration-jobs \
create MIGRATION_JOB_ID \
  --no-async \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME \
  --source=SOURCE_CONNECTION_PROFILE_ID \
  --destination=DESTINATION_CONNECTION_PROFILE_ID \
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST \
  --type=CONTINUOUS]

Windows (PowerShell)

gcloud database-migration migration-jobs `
create MIGRATION_JOB_ID `
  --no-async `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME `
  --source=SOURCE_CONNECTION_PROFILE_ID `
  --destination=DESTINATION_CONNECTION_PROFILE_ID `
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST `
  --type=CONTINUOUS]

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
create MIGRATION_JOB_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME ^
  --source=SOURCE_CONNECTION_PROFILE_ID ^
  --destination=DESTINATION_CONNECTION_PROFILE_ID ^
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST ^
  --type=CONTINUOUS]

Deberías recibir una respuesta similar a la que figura a continuación:

Waiting for migration job [MIGRATION_JOB_ID]
to be updated with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

Agrega bases de datos al trabajo de migración

Para agregar una base de datos nueva al trabajo de migración, primero debes crear una carpeta nueva dedicada en tu bucket de Cloud Storage y subir los archivos de copia de seguridad allí. Consulta Cómo configurar buckets de Cloud Storage.

Cuando tengas los archivos de copia de seguridad necesarios en el bucket de Cloud Storage, 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 de tu trabajo de migración.

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

  3. Haz clic en Edit.
  4. En la sección Seleccionar bases de datos para migrar, usa las casillas de verificación para seleccionar la base de datos nueva que deseas agregar a la tarea de migración.
  5. Opcional: Si usas copias de seguridad encriptadas, proporciona las claves de encriptación para ellas. Para obtener más detalles sobre el uso de copias de seguridad encriptadas, consulta Cómo usar copias de seguridad encriptadas.

    Realiza las siguientes acciones:

    • Haz clic en Editar detalles junto a la base de datos que seleccionaste para la migración.

      Se abrirá el panel lateral Encriptación.

    • Usa los menús desplegables Clave de encriptación para seleccionar tus claves.
    • En el campo Contraseña, ingresa la contraseña de la clave de encriptación.
    • Haz clic en Guardar y salir.

gcloud

En este ejemplo, se usa la marca opcional --no-async para que todas las operaciones se realicen de forma síncrona. Esto significa que algunos comandos pueden tardar un poco en completarse. Puedes omitir la marca --no-async para ejecutar comandos de forma asíncrona. Si es así, debes usar el comando gcloud database-migration operations describe para verificar si la operación se realizó correctamente.

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.
  • COMMA_SEPARATED_DATABASE_ID_LIST con una lista de identificadores de bases de datos del servidor SQL que deseas migrar desde tus archivos de copia de seguridad, separados por comas Estos identificadores deben ser los mismos que los nombres de las carpetas de la base de datos en tu cuenta de Cloud Storage.

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

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud database-migration migration-jobs \
update MIGRATION_JOB_ID \
  --region=REGION \
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

Windows (PowerShell)

gcloud database-migration migration-jobs `
update MIGRATION_JOB_ID `
  --region=REGION `
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
update MIGRATION_JOB_ID ^
  --region=REGION ^
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

Deberías recibir una respuesta similar a la que figura a continuación:

Waiting for migration job [MIGRATION_JOB_ID]
to be updated with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

Edita un trabajo de migración

En el caso de los trabajos de migración que no son borradores, puedes usar Google Cloud CLI para cambiar su nombre visible.

En este ejemplo, se usa la marca opcional --no-async para que todas las operaciones se realicen de forma síncrona. Esto significa que algunos comandos pueden tardar un poco en completarse. Puedes omitir la marca --no-async para ejecutar comandos de forma asíncrona. Si es así, debes usar el comando gcloud database-migration operations describe para verificar si la operación se realizó correctamente.

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.
  • MIGRATION_JOB_NAME por un nombre legible para tu trabajo de migración. Este valor se muestra en Database Migration Service en la consola de Google Cloud .

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud database-migration migration-jobs \
update MIGRATION_JOB_ID \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME

Windows (PowerShell)

gcloud database-migration migration-jobs `
update MIGRATION_JOB_ID `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
update MIGRATION_JOB_ID ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME

Deberías recibir una respuesta similar a la que figura a continuación:

Waiting for migration job [MIGRATION_JOB_ID]
to be updated with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

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