Promoción significa que la instancia de Cloud SQL de destino se desconecta del origen y pasa de ser una instancia de réplica a una instancia principal.
En el caso de las migraciones continuas, puedes iniciar el proceso de promoción cuando sea el momento de transferir las lecturas y escrituras al destino.
En las migraciones únicas, la instancia de Cloud SQL está lista en cuanto se completa la exportación e importación, y no es necesario que el usuario inicie la promoción.
Para promocionar una migración sin perder información, sigue estos pasos:
Haga clic en la tarea de migración que represente la migración que quiera promover. Se mostrará la página Detalles de la tarea de migración.
Una vez que se haya completado la fase de volcado completo y la tarea de migración esté en la fase de CDC, estará disponible la opción de promoción.
Inmediatamente después de pasar a la fase de CDC, en función del tamaño del volcado, puede haber un retraso de replicación prolongado porque la instancia de destino de Cloud SQL se pone al día con los cambios que se han producido durante el volcado y la carga.
Espera a que el retraso de la replicación se reduzca significativamente, idealmente en el orden de minutos o segundos. El retraso de replicación se puede consultar en la página de la tarea de migración.
Cuando la latencia de replicación sea mínima, podrás iniciar la promoción.
Para evitar que se pierdan datos, haz lo siguiente:
Detén todas las operaciones de escritura, las secuencias de comandos en ejecución y las conexiones de cliente a la base de datos de origen. Aquí empieza el periodo de inactividad.
Espera hasta que la latencia de replicación sea cero, lo que significa que el trabajo de migración ha procesado todos los cambios pendientes.
En la página Detalles de la tarea de migración, haz clic en Promover.
En la ventana ¿Promocionar tarea de migración?, haz clic en Promocionar.
La tarea de migración deja de leer datos de la fuente y el subestado es
Promote in progress. En este punto, no puedes detener ni deshacer el proceso de promoción.
La instancia de destino se convierte en una instancia principal de escritura.
El estado de la tarea de migración es Completed.
(Opcional) En el caso de las fuentes que usan la extensión pg_cron:
Database Migration Service no migra la extensión pg_cron (ni ningún ajuste de cron asociado a la extensión), pero sí se admite en
los destinos de Cloud SQL para PostgreSQL. Si usas la extensión pg_cron
en tus bases de datos de origen, puedes volver a instalarla en tu instancia de destino.
Ahora, la aplicación se puede conectar a la instancia de Cloud SQL y la tarea de migración se puede eliminar de forma segura.
Las tareas de migración que han fallado o se han detenido manualmente durante la fase de CDC se pueden promover, pero esto puede provocar que haya una diferencia entre los datos de origen y los de destino.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-21 (UTC)."],[[["\u003cp\u003ePromotion of a migration job turns the destination Cloud SQL instance from a replica into a primary instance, disconnecting it from the source.\u003c/p\u003e\n"],["\u003cp\u003eFor continuous migrations, promotion should be initiated after the decision to switch reads and writes to the destination has been made, while one-time migrations are ready after the dump and load process completes.\u003c/p\u003e\n"],["\u003cp\u003eBefore promoting, it's crucial to stop all writes and connections to the source database and wait for the replication delay to reach zero to avoid data loss.\u003c/p\u003e\n"],["\u003cp\u003eThe promotion process can be initiated in the Migration job details page by clicking "Promote," and once started, it cannot be stopped or reversed.\u003c/p\u003e\n"],["\u003cp\u003eIf the \u003ccode\u003epg_cron\u003c/code\u003e extension is used in the source database, it is not migrated by Database Migration Service, but can be reinstalled on the destination instance after promotion.\u003c/p\u003e\n"]]],[],null,["# Promote a migration\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n[MySQL](/database-migration/docs/mysql/promote-migration \"View this page for the MySQL version of Database Migration Service.\") \\| PostgreSQL \\| [PostgreSQL to AlloyDB](/database-migration/docs/postgresql-to-alloydb/promote-migration \"View this page for the PostgreSQL to AlloyDB version of Database Migration Service.\")\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\nPromotion means that the destination Cloud SQL instance is disconnected from\nthe source, and is promoted from a replica instance to a primary instance.\n\n\nFor continuous migrations, you can initiate the promotion process\nafter it's time to move reads and writes to the destination.\nFor one-time migrations, the Cloud SQL instance is ready as soon as the dump and load is complete, and user-invoked promotion isn't required.\n\nTo promote a migration without loss of information, follow these steps:\n\n1. Go to the [Migration jobs](https://console.cloud.google.com/dbmigration/migrations) page.\n2. Click the migration job that represents the migration that you want to promote. The **Migration job details** page appears.\n\n3. After the full dump phase has completed and the migration job is in CDC phase, the option for promotion is available.\n4. Immediately after transitioning to the CDC phase, depending on the size of the dump, there may be a long replication delay because the Cloud SQL destination instance catches up on changes that occurred during the dump and\n load.\n\n Wait for the replication delay to trend down significantly, ideally on the\n order of minutes or seconds. The replication delay is available for review on\n the migration job page.\n5. After the replication delay is at a minimum, you can initiate the promotion. To avoid data loss, make sure to:\n 1. **Stop all writes, running scripts, and client connections to the source\n database**. The downtime period begins here.\n 2. Wait until the replication delay is at zero, which means that the migration job has processed all outstanding changes.\n\n | You can promote a migration even if the replication delay isn't at zero. This can reduce the database downtime, but may affect the accuracy of the data in the destination.\n6. In the **Migration job details** page, click **Promote**.\n7. In the **Promote migration job?** window, click **Promote**.\n8. The migration job stops reading from the source and the substatus is `Promote in progress`. At this point, you cannot stop or undo the promotion process.\n9. The destination instance is promoted to a primary writeable instance. The migration job status is `Completed`.\n10. (Optional) **For sources that use the `pg_cron` extension** : The [`pg_cron`](/sql/docs/postgres/extensions#pg_cron) extension (or any `cron` settings associated with the extension) isn't migrated by Database Migration Service, but it is supported in Cloud SQL for PostgreSQL destinations. If you use the `pg_cron` extension in your source databases, you can re-install it on your destination instance.\n11. The application can now be connected to the Cloud SQL instance and the migration job can be safely deleted.\n\nMigration jobs that have failed or were manually stopped during CDC phase can be promoted, but this may mean a gap between the data on the source and the destination."]]
