A promoção significa que a instância de destino do Cloud SQL é desconectada da
origem e é promovida de uma instância de réplica para uma principal.
Para migrações contínuas, é possível iniciar o processo de promoção
quando for hora de mover as leituras e gravações para o destino.
Para migrações únicas, a instância do Cloud SQL fica pronta assim que o despejo e a carga são concluídos,
e a promoção acionada pelo usuário não é necessária.
Para promover uma migração sem perda de informações, siga estas etapas:
Clique no job de migração que representa a migração que você quer promover. A página Detalhes do job de migração é exibida.
Depois que a fase de despejo completa for concluída e o job de migração estiver na fase de CDC, a opção de promoção estará disponível.
Imediatamente após a transição para a fase de CDC, dependendo do tamanho do despejo, pode haver um longo atraso na replicação porque a instância de destino do Cloud SQL acompanha as mudanças que ocorreram durante o despejo e a carga.
Aguarde o atraso da replicação diminuir significativamente, preferencialmente na
ordem de minutos ou segundos. O atraso de replicação está disponível para revisão na
página do job de migração.
Depois que o atraso da replicação estiver no mínimo, você poderá iniciar a promoção.
Para evitar a perda de dados, faça o seguinte:
Interrompa todas as gravações, scripts em execução e conexões de clientes no banco de dados de origem. O período de inatividade começa aqui.
Aguarde até que o atraso da replicação seja zero, o que significa que o job de migração processou todas as mudanças pendentes.
Na página Detalhes do job de migração, clique em Promover.
Na janela Promover job de migração?, clique em Promover.
O job de migração para de ler da origem, e o substatus é
Promote in progress. Nesse ponto, não é possível interromper ou desfazer o
processo de promoção.
A instância de destino é promovida a uma instância principal gravável.
O status do job de migração é Completed.
(Opcional) Para origens que usam a extensão pg_cron:
a extensão pg_cron (ou qualquer configuração cron associada a ela)
não é migrada pelo Database Migration Service, mas é aceita em
destinos do Cloud SQL para PostgreSQL. Se você usar a extensão pg_cron nos bancos de dados de origem, poderá reinstalá-la na instância de destino.
Agora o aplicativo pode ser conectado à instância do Cloud SQL, e o job de migração pode ser excluído com segurança.
Jobs de migração que falharam ou foram interrompidos manualmente durante a fase de CDC podem ser
promovidas, mas isso pode significar uma lacuna entre os dados na origem e no
destino.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-18 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,[]]
