En el caso de las migraciones heterogéneas de Oracle a Cloud SQL para PostgreSQL, puedes supervisar y administrar el progreso de la migración para todo el trabajo de migración o para las tablas individuales incluidas en el trabajo de migración.
En esta página, se describen las acciones que puedes realizar en cada nivel. Para obtener más información, consulta las secciones Administra trabajos de migración y Administra tablas individuales.
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 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 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.
Para las migraciones continuas: En algunos casos, la base de datos de origen debe conservar los datos hasta que reanudes el trabajo de migración. Es posible que el período de retención de la base de datos de origen sea limitado. Si el trabajo de migración se pausa por más tiempo que el período de retención y, luego, se reanuda, esto puede provocar que falle. Si esto sucede, borra o reinicia el trabajo de migración. |
| Currículum | Cuando reanudas un trabajo de migración, Database Migration Service reanuda las operaciones de movimiento de datos:
|
| 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 del motivo por el que falló:
|
| Editar | Consulta Edita un trabajo de migración. |
| Borrar | Se puede borrar un trabajo de migración. El resultado depende del estado del trabajo:
|
| Promocionar | Durante el proceso de migración, la base de datos de destino se coloca 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, promover el trabajo de migración actualiza la base de datos de destino a una réplica independiente. Consulta Asciende una migración. |
Revisar un trabajo de migración
- En la consola de Google Cloud , ve a la página Trabajos de migración.
- 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 hora en que se creó el trabajo de migración y el tiempo que lleva en ejecución.
- El estado y el subestado del trabajo de migración, y la información adicional. Hay diferentes acciones disponibles según el estado y el subestado del trabajo de migración.
Inicia un trabajo de migración
Cuando el trabajo de migración se cree por completo (es decir, no se guarde en 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:
- En la consola de Google Cloud , ve a la página Trabajos de migración.
- 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.
- Haz clic en Iniciar.
- En el cuadro de diálogo, haz clic en Iniciar.
Desde la instancia de destino:
- En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.
- 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.
- En la sección Migración, haz clic en Iniciar.
- 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 listpara 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:
- Usa el comando
gcloud database-migration migration-jobs describepara ver el estado del trabajo de migración. - Usa
gcloud database-migration operations describecon OPERATION_ID para ver el estado de la operación en sí.
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:
- En la consola de Google Cloud , ve a la página Trabajos de migración.
- 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.
- Haz clic en Detener.
- En el diálogo, haz clic en Detener.
Desde la instancia de destino:
- En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.
- 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.
- En la sección Migración, haz clic en Detener.
- 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 listpara 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
- Usa el comando
gcloud database-migration migration-jobs describepara ver el estado del trabajo de migración. - Usa
gcloud database-migration operations describecon OPERATION_ID para ver el estado de la operación en sí.
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:
- En la consola de Google Cloud , ve a la página Trabajos de migración.
- 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.
- Haz clic en Reanudar.
- En el cuadro de diálogo, haz clic en Reanudar.
Desde la instancia de destino:
- En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.
- 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.
- En la sección Migración, haz clic en Reanudar.
- 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 listpara 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
- Usa el comando
gcloud database-migration migration-jobs describepara ver el estado del trabajo de migración. - Usa
gcloud database-migration operations describecon OPERATION_ID para ver el estado de la operación en sí.
Reinicia un trabajo de migración
Cuando reinicias un trabajo de migración, Database Migration Service borra todos los datos de las tablas de destino; tus datos de origen no se ven afectados. Luego, el proceso de migración comienza de nuevo, con la etapa de volcado completo.
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:
- En la consola de Google Cloud , ve a la página Trabajos de migración.
- 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.
- Haz clic en Reiniciar.
- En el diálogo, haz clic en Restart.
Desde la instancia de destino:
- En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.
- 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.
- En la sección Migración, haz clic en Reiniciar.
- En el diálogo, haz clic en Restart.
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 listpara 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 \ 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
- Usa el comando
gcloud database-migration migration-jobs describepara ver el estado del trabajo de migración. - Usa
gcloud database-migration operations describecon OPERATION_ID para ver el estado de la operación en sí.
Actualiza un trabajo de migración en borrador
Para terminar de crear un trabajo de migración, sigue estos pasos:
- En la consola de Google Cloud , ve a la página Trabajos de migración.
- 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.
- Termina de crear el trabajo de migración. Consulta Crea un trabajo de migración.
Edita un trabajo de migración
Puedes modificar la información de configuración de la fuente, como las tablas y los esquemas de la base de datos en la fuente que Database Migration Service migrará al destino. Database Migration Service usa esta información de configuración para migrar los datos correctos del origen al destino.
Agrega o quita objetos de la migración
Para agregar o quitar tablas o esquemas de la migración, haz lo siguiente:
Ve a la página Trabajos de migración en la consola de Google Cloud .
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.
En la sección Selecciona objetos que quieras 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.
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 iniciará la migración desde el principio, después de limpiar las tablas que selecciones en el destino.
Ajusta las conexiones simultáneas máximas a la base de datos de origen
Puedes personalizar la cantidad máxima de conexiones simultáneas que Database Migration Service puede realizar a tu instancia de origen para la fase de volcado completo o la fase de CDC.
Ve a la página Trabajos de migración en la consola de Google Cloud .
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.
Expande la sección Personaliza la configuración de la fuente > Configuración de lectura de la fuente.
En las secciones Cantidad máxima de conexiones de volcado completo simultáneas o Cantidad máxima 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 CDC.
Haz clic en Guardar o Guardar y reiniciar.
Ajusta los parámetros de configuración del 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:
Ve a la página Trabajos de migración en la consola de Google Cloud .
- 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.
- Expande la sección Personalizar la configuración de destino y modifica
los siguientes parámetros de configuración:
- Máximo de conexiones de destino simultáneas
-
Valor predeterminado:
128Valores permitidos: mínimo
2, máximo256Puedes personalizar la cantidad máxima de conexiones simultáneas que Database Migration Service puede establecer con tu instancia de destino.
Database Migration Service ajusta la cantidad de conexiones para garantizar el mejor rendimiento dentro del límite de conexiones proporcionado. Aumentar el límite máximo de conexiones puede mejorar la velocidad de la migración, pero genera una carga adicional en las bases de datos de destino.
- Tiempo de espera de la transacción
-
Valor predeterminado:
30Valores permitidos: mínimo
30, máximo300Durante el proceso de migración, Database Migration Service puede encontrar ciertos problemas que causan 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 el trabajo de migración. El trabajo de migración sigue copiando datos, pero pasa al estado En ejecución con errores. Puedes ver los detalles del trabajo de migración para verificar qué problemas se deben abordar.
- 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 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 listpara 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
- Usa el comando
gcloud database-migration migration-jobs describepara ver el estado del trabajo de migración. - Usa
gcloud database-migration operations describecon OPERATION_ID para ver el estado de la operación en sí.
Administra tablas individuales
En el caso de las migraciones heterogéneas de Oracle a Cloud SQL para PostgreSQL, puedes ver los detalles del estado de las tablas específicas incluidas en tu trabajo de migración.
Visualiza todas las tablas de un trabajo
Para ver los detalles de todas las tablas de un trabajo de migración, haz lo siguiente:
Console
- En la consola de Google Cloud , ve a la página Trabajos de migración.
- 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.
- Selecciona la pestaña Tablas y consulta todas las tablas incluidas en tu trabajo. También puedes usar filtros interactivos para limitar la lista.
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 listpara 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 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
Este comando devuelve el estado, la fase y los detalles del error de todas las tablas incluidas en el trabajo de migración, separados por líneas vacías.
SOURCE_OBJECT: {'schema': 'Schema1', 'table': 'MyTable1', 'type': 'TABLE'}
STATE: RUNNING
PHASE: CDC
ERROR: {}
SOURCE_OBJECT: {'schema': 'Production', 'table': 'MyTable2', 'type': 'TABLE'}
STATE: RUNNING
PHASE: FULL_DUMP
ERROR:
{ 'code': 2,
'details': [
{ '@type': 'type.googleapis.com/google.rpc.ErrorInfo',
'domain': 'datamigration.googleapis.com',
'metadata': {
'errorMessage': '[DATABASE] error trying to write processed rows.
Line: 2619 Position: 0 Schema: production Table: mytable2',
'errorScope': 'NON_GLOBAL',
'objectId': 'Production_MyTable2',
'projectName': 'PROJECT_ID',
'resourceName': 'MIGRATION_JOB_ID',
'severity': 'ERROR'
},
'reason': 'DESTINATION_WRITE_ERROR'
}
],
'message': 'Encountered errors with your migration job table. Check the `details`
array for specific information on each issue.'
}
Consulta los detalles de una sola tabla
Para ver los detalles de la migración de una sola tabla, haz lo siguiente:
Console
- En la consola de Google Cloud , ve a la página Trabajos de migración.
- 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.
-
Selecciona la pestaña Tablas y haz clic en la tabla que quieras inspeccionar. También puedes usar filtros interactivos para limitar la lista.
Se abrirá el panel lateral de detalles de la tabla.
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 listpara 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.
- SCHEMA_NAME por el nombre del esquema superior que contiene tu tabla.
- TABLE_NAME por el nombre de tu tabla.
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud database-migration objects lookup \ --migration-job=MIGRATION_JOB_ID \ --region=REGION \ --schema=SCHEMA_NAME \ --table=TABLE_NAME
Windows (PowerShell)
gcloud database-migration objects lookup ` --migration-job=MIGRATION_JOB_ID ` --region=REGION ` --schema=SCHEMA_NAME ` --table=TABLE_NAME
Windows (cmd.exe)
gcloud database-migration objects lookup ^ --migration-job=MIGRATION_JOB_ID ^ --region=REGION ^ --schema=SCHEMA_NAME ^ --table=TABLE_NAME
Resultado
Este comando devuelve el estado, la fase, la hora de creación y los detalles del error de tu tabla. Toda la respuesta es una cadena de varias líneas con formato YAML. Por ejemplo:
createTime: '2025-06-02T10:20:29.792832Z'
error:
code: 2
details:
- '@type': type.googleapis.com/google.rpc.ErrorInfo
domain: datamigration.googleapis.com
metadata:
errorMessage: '[DATABASE] error trying to write processed rows.
Line: 2619 Position: 0 Schema: production Table: mytable2'
errorScope: NON_GLOBAL
objectId: Production_MyTable2
projectName: PROJECT_ID
resourceName: MIGRATION_JOB_ID
severity: ERROR
reason: DESTINATION_WRITE_ERROR
message: Encountered errors with your migration job table. Check the `details` array
for specific information on each issue.
name: projects/PROJECT_ID/locations/REGION/migrationJobs/MIGRATION_JOB_ID/objects/TABLE_UUID
phase: FULL_DUMP
sourceObject:
schema: Production
table: MyTable2
type: TABLE
state: RUNNING