Promover um job de migração

Para migrações contínuas, é possível iniciar o processo de promoção quando for hora de mover leituras e gravações para os bancos de dados de destino. A promoção significa que os bancos de dados migrados do Cloud SQL agora ficam acessíveis para todas as operações de leitura e gravação.

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

1. Inicie a promoção. Para evitar a perda de dados, interrompa todas as gravações, scripts em execução e conexões de cliente com o banco de dados de origem. O período de inatividade começa aqui.
2. Verifique se todos os dados disponíveis dos arquivos de registro de transação são replicados para a instância de destino do Cloud SQL para SQL Server.

   Para conseguir esse resultado, realize uma das seguintes ações:

   • Pare os uploads de arquivos de backup automatizados ou faça upload do último arquivo de registro de transações. Monitore o tamanho dos backups de logs de transação não processados para determinar quando o Database Migration Service termina de processar esse arquivo.
   • Se preferir, faça upload de um arquivo de registro de transações com o nome que termina em sufixo .trn.final. O serviço de migração de banco de dados interrompe as cargas contínuas quando detecta um arquivo de backup com um nome que corresponde à convenção de sufixo .trn.final.

     Quando o Database Migration Service terminar de processar esse arquivo, o status do job de migração vai mudar para Pronto para promover.

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 você 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 aparece.

      • 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 vários bancos de dados que você quer promover vai aparecer.

   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.

   • REGION com o identificador da região em que o perfil de conexão é salvo.

   Execute o seguinte comando:

   Linux, macOS ou Cloud Shell

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

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

   Windows (PowerShell)

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

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

   Windows (cmd.exe)

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

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

   Resultado

   A ação é realizada de forma assíncrona. Assim, esse comando retorna uma entidade de operação 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 saber se a operação foi concluída, consulte o objeto de operação retornado ou verifique o status do job de migração:

   • Use o comando gcloud database-migration migration-jobs describe para conferir o status do job de migração.
   • Use o gcloud database-migration operations describe com o OPERATION_ID para conferir o status da operação.
4. A instância de destino ou os bancos de dados selecionados são promovidos, e os bancos de dados migrados agora estão acessíveis para todas as operações de leitura e gravação. O status do job de migração muda para Completed.
5. Agora o aplicativo pode ser conectado à instância do Cloud SQL, e o job de migração pode ser excluído com segurança.