Promover um job de migração

Para migrações contínuas, é possível iniciar o processo de promoção quando você estiver pronto para transferir os aplicativos para os bancos de dados de destino. A promoção do job de migração desconecta a instância de destino da origem, transforma-a em uma instância de banco de dados principal independente para que você possa retomar os backups automáticos, configurar a recuperação pontual (PITR) e criar réplicas de leitura.

É possível promover um job de migração ou promover bancos de dados selecionados de um job de migração.

  1. Interrompa todas as gravações, scripts em execução e conexões de clientes com o banco de dados de origem. O período de inatividade começa aqui.
  2. Aguarde até que a métrica de atraso de replicação esteja em zero ou próxima de zero. Isso significa que o job de migração processou todas as alterações pendentes.

    É possível promover uma migração mesmo que o atraso de replicação não esteja em zero. Isso pode reduzir o tempo de inatividade do banco de dados, mas pode afetar a precisão dos dados no destino.

  3. Execute a ação de promoção:

    Console

    1. No console do Google Cloud , acesse a página Jobs de migração.

      Acessar Jobs de migração

    2. Na guia Jobs, clique no nome de exibição do job de migração que você quer promover.

      A página de detalhes do job de migração é aberta.

    3. Realize uma das seguintes ações de promoção:
      • Se quiser promover todos os bancos de dados incluídos na migração, clique em Promover na barra de ferramentas do job de migração.

        A caixa de diálogo de promoção do job de migração é exibida.

      • Se você quiser promover apenas bancos de dados específicos, selecione-os usando as caixas de seleção ao lado dos nomes dos bancos de dados e, na guia Bancos de dados, clique em Promover.

        A caixa de diálogo com o número de bancos de dados que você quer promover é exibida.

    4. Na caixa de diálogo, verifique se não há erros e clique em Promover.

    gcloud

    Antes de usar os dados do comando abaixo, faça estas substituições:

    • MIGRATION_JOB_ID pelo identificador do job de migração.

      Se você não souber o identificador, use o comando gcloud database-migration migration-jobs list para listar todos os jobs de migração em uma determinada região e conferir os identificadores deles.

    • REGION pelo identificador da região em que o perfil de conexão está salvo.

    Execute o seguinte comando:

    Linux, macOS ou Cloud Shell

    gcloud database-migration migration-jobs \
    promote MIGRATION_JOB_ID \
      --region=REGION

    Windows (PowerShell)

    gcloud database-migration migration-jobs `
    promote MIGRATION_JOB_ID `
      --region=REGION

    Windows (cmd.exe)

    gcloud database-migration migration-jobs ^
    promote MIGRATION_JOB_ID ^
      --region=REGION

    Resultado

    A ação é realizada de maneira assíncrona. Assim, esse comando retorna uma entidade Operation que representa uma operação de longa duração:

    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 se a operação foi bem-sucedida, consulte o objeto de operação retornado ou verifique o status do job de migração:

  4. A instância de destino ou os bancos de dados selecionados são promovidos. A instância de destino é desconectada da origem, se torna uma instância principal independente e está pronta para o tráfego completo do aplicativo. O status do job de migração muda para Completed.
  5. (Opcional) Para origens que usam a extensão pg_cron: a extensão pg_cron (ou qualquer configuração cron associada à extensão) não é migrada pelo Database Migration Service, mas é compatível com 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.
  6. Agora é possível conectar o aplicativo à instância do Cloud SQL e excluir o job de migração.