Administrar 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 en la consola de Google Cloud (desde la consola de Database Migration Service o directamente desde la página de la instancia de Cloud SQL de destino) y con Google Cloud CLI.

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 estén en borrador para realizar los siguientes cambios:
Comenzar Inicia los 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 Detén un trabajo de migración en ejecución. El movimiento de datos está pausado. El estado del trabajo de migración primero cambia a Stopping y, luego, a Stopped. Puedes reanudar, borrar o promover un trabajo de migración detenido.
Currículum 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 recoge 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 haya encontrado un error y no pueda continuar con la replicación de datos.

El resultado de reiniciar un trabajo de migración depende de uno de los siguientes motivos por los que falló:

  • Los trabajos de migración con errores 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 completa.
  • Si la replicación falló debido a un error en una o más bases de datos de origen o 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 replicará 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 está en el estado Completed, el registro se borra de la lista de trabajos de migración.
  • Si el trabajo de migración se encuentra en cualquier otro estado, existe la opción de borrar el par de instancia principal y de destino de Cloud SQL.
Promocionar Durante el proceso de migración, las bases de datos de Cloud SQL para SQL Server de destino se colocan 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 asciendas el trabajo de migración o las bases de datos seleccionadas. Para obtener más información, consulta Asciende una migración.
Ver Puedes ver los detalles de una base de datos específica en un trabajo de migración o todas las bases de datos que seleccionaste para la migración.

Inicia un trabajo de migración

Cuando el trabajo de migración se cree por completo (es decir, no se guarde en un estado de borrador), puedes iniciarlo en cualquier momento para comenzar a migrar datos.

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

Console

Puedes iniciar un trabajo de migración desde la consola de Database Migration Service o desde la página de la instancia de destino.

Desde la consola de Database Migration Service:

  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.

Desde la instancia de destino:

  1. En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Haz clic en el nombre visible de la instancia de destino de tu migración.

    Se abre la página de detalles de la instancia.

  3. En la sección Migración, 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, haz 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 por el identificador de la región en la que se guarda tu trabajo de migració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 que se muestra 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. Para ello, sigue estos pasos:

Console

Puedes detener un trabajo de migración desde la consola de Database Migration Service o desde la página de la instancia de destino.

Desde la consola de Database Migration Service:

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

    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.

Desde la instancia de destino:

  1. En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Haz clic en el nombre visible de la instancia de destino de tu migración.

    Se abre la página de detalles de la instancia.

  3. En la sección Migración, 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, haz 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 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 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 que se muestra o verificar el estado del trabajo de migración:

Reanuda un trabajo de migración

Puedes reanudar un trabajo de migración detenido siguiendo estos pasos:

Console

Puedes reanudar un trabajo de migración desde la consola de Database Migration Service o desde la página de la instancia de destino.

Desde la consola de Database Migration Service:

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

    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.

Desde la instancia de destino:

  1. En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Haz clic en el nombre visible de la instancia de destino de tu migración.

    Se abre la página de detalles de la instancia.

  3. En la sección Migración, 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, haz 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 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 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 que se muestra o verificar el estado del trabajo de migración:

Reinicia un trabajo de migración

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

Console

Puedes reiniciar un trabajo de migración desde la consola de Database Migration Service o desde la página de la instancia de destino.

Desde la consola de Database Migration Service:

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

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

      Aparecerá el diálogo para reiniciar el trabajo de migración.

    • Si solo quieres reiniciar bases de datos específicas, selecciónalas con las casillas de verificación junto a los nombres de las bases de datos y, en la pestaña Bases de datos, haz clic en Reiniciar.

      Aparecerá el diálogo con la cantidad de bases de datos que deseas reiniciar.

  4. En el diálogo, haz clic en Reiniciar.

Desde la instancia de destino:

  1. En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Haz clic en el nombre visible de la instancia de destino de tu migración.

    Se abre la página de detalles de la instancia.

  3. En la sección Migración, haz clic en Reiniciar.
  4. En el diálogo, haz clic en Reiniciar.

gcloud

Antes de usar cualquiera de los datos de comando a continuación, haz 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 por el identificador de la región en la que se guarda tu trabajo de migración.

  • Opcional: Database Migration Service migra todas las bases de datos de tu fuente 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 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 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 que se muestra o verificar el estado del trabajo de migración:

Actualiza un trabajo de migración en borrador

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.

    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. Termina de crear el 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 lo haces, debes usar el comando gcloud database-migration operations describe para verificar si la operación se realizó de forma correcta.

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

  • MIGRATION_JOB_ID por un identificador legible por máquinas para tu trabajo de migración.
  • REGION por el identificador de la región en la que deseas guardar el perfil de conexión.
  • MIGRATION_JOB_NAME por un nombre legible por humanos para tu trabajo de migración. Este valor se muestra en Database Migration Service en la consola de Google Cloud .
  • SOURCE_CONNECTION_PROFILE_ID por un identificador legible por máquinas del perfil de conexión de origen.
  • DESTINATION_CONNECTION_PROFILE_ID por 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 diferencial 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 diferencial en tu 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 compatibles, consulta Tipos de archivos de copia de seguridad compatibles.

  • COMMA_SEPARATED_DATABASE_ID_LIST por una lista separada por comas de identificadores de bases de datos de SQL Server que deseas migrar desde tus archivos de copia de seguridad.

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 o quita bases de datos del trabajo de migración

Para agregar una base de datos nueva al trabajo de migración, primero debes crear una carpeta dedicada nueva en tu bucket de Cloud Storage y subir los archivos de copia de seguridad allí. Consulta Configura 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.

    Ir 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 Editar.
  4. En la sección Selecciona las bases de datos que se migrarán, usa las casillas de verificación para seleccionar la base de datos nueva que deseas agregar al trabajo de migración o desmarca las que deseas quitar.
  5. (Opcional) Si usas copias de seguridad encriptadas, proporciona las claves de encriptación para tus copias de seguridad. Para obtener más detalles sobre el uso de copias de seguridad encriptadas, consulta Usa 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 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 lo haces, debes usar el comando gcloud database-migration operations describe para verificar si la operación se realizó de forma correcta.

Antes de usar cualquiera de los datos de comando a continuación, haz 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 por el identificador de la región en la que se guarda tu perfil de conexión.
  • COMMA_SEPARATED_DATABASE_ID_LIST por una lista separada por comas de identificadores de bases de datos de SQL Server que deseas migrar desde tus archivos de copia de seguridad. Estos identificadores deben ser los mismos que los nombres de las carpetas de la base de datos en tu 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 que no sea un borrador

En el caso de los trabajos de migración que no son borradores, puedes usar Google Cloud CLI para cambiar el nombre visible del trabajo 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 un poco 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 realizó de forma correcta.

Antes de usar cualquiera de los datos de comando a continuación, haz 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 por el identificador de la región en la que se guarda tu perfil de conexión.
  • MIGRATION_JOB_NAME por un nombre legible por humanos 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 alcanzar 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 creas en el asistente de creación de trabajos de migración (consulta Crea 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, haz 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 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 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 que se muestra o verificar el estado del trabajo de migración:

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

Cuando el trabajo de migración se crea por completo (es decir, no se guarda en un estado de borrador), puedes usar Google Cloud CLI para ver los detalles de una base de datos específica en ese trabajo 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 un poco 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 realizó de forma correcta.

Antes de usar cualquiera de los datos de comando a continuación, haz 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 por el identificador de la región en la que se guarda tu perfil de conexión.
  • DATABASE_NAME por el nombre de la base de datos.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID \
  --region=REGION --database=DATABASE_NAME

Windows (PowerShell)

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID `
  --region=REGION --database=DATABASE_NAME

Windows (cmd.exe)

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID ^
  --region=REGION --database=DATABASE_NAME

Resultado

El resultado es similar a lo 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 realizó correctamente, puedes consultar el objeto de operación que se muestra o verificar el estado del trabajo de migración:

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

Cuando tu trabajo de migración se crea por completo (es decir, no se guarda en un estado de borrador), puedes usar Google Cloud CLI para enumerar todas las bases de datos que seleccionaste 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 un poco 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 realizó de forma correcta.

Antes de usar cualquiera de los datos de comando a continuación, haz 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 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 objects list --migration-job=MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

gcloud database-migration objects list --migration-job=MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

gcloud database-migration objects list --migration-job=MIGRATION_JOB_ID ^
  --region=REGION

Resultado

El resultado es similar a lo 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 realizó correctamente, puedes consultar el objeto de operación que se muestra o verificar el estado del trabajo de migración: