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 las siguientes acciones en los trabajos de migración:

Acción	Descripción
Editar	Puedes editar los trabajos de migración que no sean borradores para hacer los siguientes cambios: Actualiza el nombre visible de la tarea de migración con la herramienta de línea de comandos gcloud. Para obtener más información, consulta Editar una tarea de migración que no sea un borrador. Añade o quita bases de datos de tu trabajo de migración. Para obtener más información, consulta Añadir o quitar bases de datos.
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.
Currículums	Si detienes una tarea de migración durante la carga incremental, puedes reanudarla más tarde. Cuando reanudas una tarea de migración, el servicio de migración de bases de datos recoge todos los archivos de registro de transacciones 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 de uno de los siguientes motivos por los que ha fallado: Las tareas de migración fallidas que no se pueden recuperar del error vuelven a intentar todo el proceso de migración, incluida la carga inicial del archivo de copia de seguridad completo. Si la replicación ha fallado debido a un error en una o varias bases de datos de origen o de destino, al reiniciar la migración se borrarán todos los datos de las bases de datos de destino. Si creas una carpeta para otra base de datos después de iniciar la migración y la añades a las bases de datos seleccionadas para la migración, al reiniciar la migración también se replicarán las nuevas bases de datos en la instancia de destino.
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 elegir eliminar la instancia de Cloud SQL de destino o el par principal.
Promocionar	Durante el proceso de migración, las bases de datos de destino de Cloud SQL para SQL Server se ponen en modo de recuperación, donde las gestiona por completo Database Migration Service. No puedes realizar ninguna operación de lectura o escritura en las bases de datos de destino hasta que promuevas el trabajo de migración o las bases de datos seleccionadas. Para obtener más información, consulta el artículo Promocionar una migración.
Ver	Puedes ver los detalles de una base de datos específica en una tarea de migración o todas las bases de datos que hayas seleccionado para la 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

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

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

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

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. Realiza una de las siguientes acciones para reiniciar:

   • Si quieres reiniciar todas las bases de datos incluidas en la migración, en la barra de herramientas de la tarea de migración, haz clic en Reiniciar.

     Aparecerá el cuadro de diálogo para reiniciar la tarea de migración.

   • Si solo quiere reiniciar bases de datos concretas, selecciónelas con las casillas situadas junto a sus nombres y, en la pestaña Bases de datos, haga clic en Reiniciar.

     Aparecerá un cuadro de diálogo con el número de bases de datos que quieras 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

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:

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 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 sobre cómo crear una tarea 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 en completarse. Puedes omitir la marca --no-async para ejecutar comandos de forma asíncrona. Si lo haces, debes usar el comando gcloud database-migration operations describe para verificar si la operación se ha realizado correctamente.

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

• MIGRATION_JOB_ID con un identificador legible por máquina para tu tarea de migración.
• REGION por el identificador de la región en la que quieras guardar el perfil de conexión.
• MIGRATION_JOB_NAME con un nombre legible para tu tarea de migración. Este valor se muestra en Database Migration Service en la consola. Google Cloud
• SOURCE_CONNECTION_PROFILE_ID con un identificador legible por máquina 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 copia de seguridad diferencial: puedes configurar si el trabajo de migración puede usar archivos de copia de seguridad diferencial del segmento de Cloud Storage. Añade una de las siguientes marcas a tu comando:
  • --sqlserver-diff-backup para habilitar los archivos de copia de seguridad diferencial para la migración
  • --no-sqlserver-diff-backup para inhabilitar los archivos de copia de seguridad diferencial de tu migración

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

• COMMA_SEPARATED_DATABASE_ID_LIST con una lista de identificadores de bases de datos separados por comas del SQL Server del que quieras migrar los archivos de copia de seguridad.

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 \
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)

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 `
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)

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 ^
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 siguiente:

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]

Añadir o quitar bases de datos de la tarea de migración

Para añadir una base de datos a la tarea de migración, primero debes crear una carpeta específica en tu segmento de Cloud Storage y subir los archivos de copia de seguridad a esa carpeta. Consulta Configurar segmentos de Cloud Storage.

Cuando tengas los archivos de copia de seguridad necesarios en el segmento de Cloud Storage, 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, haga 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. Haz clic en Editar.
4. En la sección Seleccionar bases de datos para migrar, usa las casillas para seleccionar la nueva base de datos que quieras añadir al trabajo de migración o desmarca las que quieras quitar.
5. (Opcional) Si usas copias de seguridad cifradas, proporciona las claves de cifrado de tus copias de seguridad. Para obtener más información sobre cómo usar copias de seguridad cifradas, consulta el artículo Usar copias de seguridad cifradas.

   Realiza las siguientes acciones:

   • Haga clic en Editar detalles junto a la base de datos que haya seleccionado para la migración.

     Se abrirá el panel lateral Cifrado.

   • Usa los menús Clave de cifrado para seleccionar tus claves.
   • En el campo Password (Contraseña), introduce la contraseña de la clave de cifrado.
   • 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 en completarse. Puedes omitir la marca --no-async para ejecutar comandos de forma asíncrona. Si lo haces, debes usar el comando gcloud database-migration operations describe para verificar si la operación se ha realizado correctamente.

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

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

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 \
update MIGRATION_JOB_ID \
  --region=REGION \
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

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 `
update MIGRATION_JOB_ID `
  --region=REGION `
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

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 ^
update MIGRATION_JOB_ID ^
  --region=REGION ^
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

Deberías recibir una respuesta similar a la siguiente:

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]

Editar una tarea de migración que no sea un borrador

En el caso de las tareas de migración que no sean borradores, puedes usar la CLI de Google Cloud para cambiar el nombre visible de la tarea de migración:

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 en completarse. Puedes omitir la marca --no-async para ejecutar comandos de forma asíncrona. Si lo haces, debes usar el comando gcloud database-migration operations describe para verificar si la operación se ha realizado correctamente.

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

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 \
update MIGRATION_JOB_ID \
  --region=REGION \
  --display-name=MIGRATION_JOB_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 migration-jobs `
update MIGRATION_JOB_ID `
  --region=REGION `
  --display-name=MIGRATION_JOB_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 migration-jobs ^
update MIGRATION_JOB_ID ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME 

Deberías recibir una respuesta similar a la siguiente:

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]

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

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.

Ver los detalles de la migración de una base de datos específica

Cuando se haya creado por completo tu tarea de migración (es decir, no se haya guardado en estado de borrador), puedes usar la CLI de Google Cloud para ver los detalles de una base de datos específica de esa tarea de migración.

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 en completarse. Puedes omitir la marca --no-async para ejecutar comandos de forma asíncrona. Si lo haces, debes usar el comando gcloud database-migration operations describe para verificar si la operación se ha realizado correctamente.

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.
• DATABASE_NAME con el nombre de la base de datos.

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 --database=DATABASE_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 --database=DATABASE_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 --database=DATABASE_NAME

Resultado

El resultado debería ser similar al siguiente:

createTime: '2025-03-21T17:05:19.211441641Z'
name: PROJECT_ID
phase: FULL_DUMP
sourceObject:
  database: DATABASE_NAME
  type: DATABASE
state: RUNNING

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.

Ver los detalles de la migración de bases de datos específicas

Cuando se haya creado por completo el trabajo de migración (es decir, no se haya guardado en borrador), puedes usar la CLI de Google Cloud para enumerar todas las bases de datos que hayas seleccionado para ese trabajo de migración y ver detalles sobre ellas.

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 en completarse. Puedes omitir la marca --no-async para ejecutar comandos de forma asíncrona. Si lo haces, debes usar el comando gcloud database-migration operations describe para verificar si la operación se ha realizado correctamente.

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

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

El resultado debería ser similar al siguiente:

Waiting for migration job MIGRATION_JOB_ID
to fetch source objects with OPERATION_ID

Waiting for operation OPERATION_ID to complete...done.

SOURCE_OBJECT                            STATE    PHASE      ERROR
{'database': 'db1', 'type': 'DATABASE'}  RUNNING  FULL_DUMP
{'database': 'db2', 'type': 'DATABASE'}  STOPPED  CDC        {'code': 1, 'message': 'Internal error'}

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.