Puedes realizar acciones desde la lista de trabajos de migración, desde la página de detalles de un solo trabajo de migración o directamente desde la página del clúster de destino en AlloyDB para PostgreSQL. En la consola de Google Cloud , puedes realizar acciones en varios trabajos de forma simultánea si todos tienen 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 algunas acciones en los trabajos de migración en su totalidad, mientras que otras acciones (como reiniciar bases de datos con errores o ver detalles) también se pueden realizar en bases de datos individuales dentro de un trabajo de migración.
Puedes realizar las siguientes acciones en los trabajos de migración:
| Acción | Descripción |
|---|---|
| Editar | Para realizar los siguientes cambios, edita el trabajo de migración:
|
| Comenzar | Iniciar trabajos de migración que se crearon sin iniciarse Puedes iniciar trabajos 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 en cualquier momento. La migración de datos se detiene,
y el estado del trabajo de migración cambia a
Supervisa las ranuras de replicación y el espacio en el disco del servidor de la base de datos de origen. Si borras el trabajo de migración, se limpiarán todas las ranuras de replicación de la fuente y se detendrá el tráfico de red. |
| Currículum | Si se detuvo un trabajo de migración continuo durante la fase de CDC, se puede reanudar. Si se reanuda el trabajo de migración, se reiniciará la replicación de los eventos y los cambios de datos que se acumularon durante el tiempo de detención. |
| Reiniciar | Si un trabajo de migración falló y no se puede recuperar, o se detuvo durante la fase de volcado completo inicial, puedes reiniciarlo desde el principio. Puedes reiniciar todas las bases de datos en el trabajo de migración o reiniciar solo las bases de datos que fallaron:
|
| Borrar | Borra un trabajo de migración. Puedes borrar los trabajos de migración en cualquier estado. Sin embargo, solo puedes borrar un trabajo de migración en ejecución en la consola de Google Cloud . El resultado depende del estado del trabajo:
Si borras un trabajo de migración, se quitan las ranuras de replicación asignadas en la base de datos de origen y se detiene el tráfico de red. Borrar un trabajo de migración no borra las bases de datos de origen. |
| Promociona |
Ascender el clúster de AlloyDB para PostgreSQL de destino de la replicación a un clúster de base de datos principal
independiente y desconectar el clúster de destino de la fuente.
Para obtener más información, consulta Asciende una migración. |
| Cómo ver una base de datos específica | Consulta los detalles de la migración de una base de datos específica configurada para la migración. |
| Ver todas las bases de datos | Consulta los detalles de la migración de todas las bases de datos configuradas 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 estado de borrador), puedes iniciarlo en cualquier momento para comenzar a migrar datos.
Para iniciar un trabajo de migración, sigue estos pasos:
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 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.
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 describecon el MIGRATION_JOB_ID para ver el estado del trabajo de migración. - Usa el comando
gcloud database-migration operations describecon el 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. Cuando detienes un trabajo de migración,
se detiene la migración de datos y el estado del trabajo de migración cambia a Stopping
y, luego, a Stopped.
Para detener un trabajo de migración, sigue estos pasos:
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 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.
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 \ 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
Si se detuvo un trabajo de migración continuo durante la fase de captura de datos modificados (CDC), puedes reanudarlo. Cuando se reanuda el trabajo de migración, se reinicia la replicación de los eventos y los cambios de datos que se acumularon en la base de datos de origen mientras el trabajo estaba detenido.
Para reanudar un trabajo de migración detenido, sigue estos pasos:
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 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.
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 \ 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
Si un trabajo de migración falló y no se puede recuperar, o se detuvo durante la fase de volcado completo inicial, puedes reiniciarlo desde el principio.
Puedes reiniciar todas las bases de datos en el trabajo de migración o reiniciar solo las bases de datos que fallaron:
- Reiniciar todas las bases de datos: Borra todos los datos de todas las bases de datos que se migran en el clúster de destino y, luego, inicia un nuevo volcado completo para ellas. Si el trabajo de migración está configurado para migrar todas las bases de datos y se crearon bases de datos nuevas en el servidor de PostgreSQL de origen desde que comenzó la migración, reiniciar el trabajo de migración también replica esas bases de datos nuevas en el clúster de destino.
- Reiniciar bases de datos con errores: Borra todos los datos solo de las bases de datos de destino que encontraron errores y, luego, inicia un nuevo volcado completo para ellas. No se verán afectadas otras bases de datos en el clúster de destino.
Para reiniciar un trabajo de migración, sigue estos pasos:
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 del trabajo de migración
que deseas reiniciar.
Se abrirá la página de detalles del trabajo de migración.
- 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 las bases de datos con errores, en la pestaña Bases de datos, haz clic en Reiniciar bases de datos con errores.
Aparecerá el diálogo con la cantidad de bases de datos con errores que se reiniciarán.
- 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.
Opcional: De forma predeterminada, cuando se reinicia un trabajo de migración, se reinician todas las bases de datos incluidas en él. Si solo quieres reiniciar las bases de datos que fallaron sin afectar a otras bases de datos que se están migrando, agrega la marca
--restart-failed-objects.
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:
Console
- 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.
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ó correctamente.
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 trabajo de migració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áquinas del perfil de conexión de destino.
- COMMA_SEPARATED_DATABASE_ID_LIST por una lista separada por comas de identificadores de bases de datos de PostgreSQL que deseas migrar.
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud database-migration migration-jobs \ update MIGRATION_JOB_ID \ --no-async \ --region=REGION \ --display-name=MIGRATION_JOB_NAME \ --source=SOURCE_CONNECTION_PROFILE_ID \ --destination=DESTINATION_CONNECTION_PROFILE_ID \ --databases-filter=COMMA_SEPARATED_DATABASE_ID_LIST \ --type=CONTINUOUS
Windows (PowerShell)
gcloud database-migration migration-jobs ` update MIGRATION_JOB_ID ` --no-async ` --region=REGION ` --display-name=MIGRATION_JOB_NAME ` --source=SOURCE_CONNECTION_PROFILE_ID ` --destination=DESTINATION_CONNECTION_PROFILE_ID ` --databases-filter=COMMA_SEPARATED_DATABASE_ID_LIST ` --type=CONTINUOUS
Windows (cmd.exe)
gcloud database-migration migration-jobs ^ update MIGRATION_JOB_ID ^ --no-async ^ --region=REGION ^ --display-name=MIGRATION_JOB_NAME ^ --source=SOURCE_CONNECTION_PROFILE_ID ^ --destination=DESTINATION_CONNECTION_PROFILE_ID ^ --databases-filter=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
Puedes agregar o quitar bases de datos en cualquier estado o fase de migración, tantas veces como sea necesario. Cuando quitas una base de datos, Database Migration Service detiene el proceso de replicación en esa base de datos, pero no la quita del clúster de AlloyDB para PostgreSQL de destino.
Para agregar o quitar bases de datos de tu 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 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.
- Haz clic en Editar.
- En la sección Selecciona las bases de datos que quieres migrar, usa las casillas de verificación para seleccionar la base de datos nueva que quieres agregar al trabajo de migración o desmarca las que quieres quitar.
- Haz clic en Guardar.
Edita un trabajo de migración que no sea un borrador
Para editar el nivel de paralelismo del volcado de datos de un trabajo de migración en ejecución, consulta Limitaciones conocidas. Debes guardar y reiniciar el trabajo de migración después de cambiar la configuración de paralelismo.
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ó correctamente.
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.
- 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 \ --no-async \ --region=REGION \ --display-name=MIGRATION_JOB_NAME
Windows (PowerShell)
gcloud database-migration migration-jobs ` update MIGRATION_JOB_ID ` --no-async ` --region=REGION ` --display-name=MIGRATION_JOB_NAME
Windows (cmd.exe)
gcloud database-migration migration-jobs ^ update MIGRATION_JOB_ID ^ --no-async ^ --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 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 \ 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:
- Usa el comando
gcloud database-migration migration-jobs describecon el MIGRATION_JOB_ID para ver el estado del trabajo de migración. - Usa el comando
gcloud database-migration operations describecon el OPERATION_ID para ver el estado de la operación en sí.
Consulta los detalles de la migración de una base de datos específica
Cuando tu trabajo de migración se cree por completo (es decir, no se guarde 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:
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.
- 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: projects/PROJECT_ID/locations/REGION/migrationJobs/MIGRATION_JOB_ID/objects/OBJECT_ID phase: FULL_DUMP sourceObject: database: DATABASE_NAME type: DATABASE state: RUNNING
Ver los detalles de la migración de bases de datos específicas
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 enumerar todas las bases de datos que seleccionaste para ese trabajo de migración y ver detalles sobre ellas:
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
El resultado es similar a lo siguiente:
SOURCE_OBJECT STATE PHASE ERROR
{'database': 'db1', 'type': 'DATABASE'} RUNNING FULL_DUMP
{'database': 'db2', 'type': 'DATABASE'} STOPPED CDC {'code': 1, 'message': 'Internal error'}