Promover um job de migração

Para migrações contínuas, é possível iniciar o processo de promoção quando for hora de mover as leituras e gravações para os bancos de dados de destino. A promoção significa que os bancos de dados do Cloud SQL migrados agora estão 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 clientes 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ções foram replicados para a instância de destino do Cloud SQL para SQL Server.

   Origens do Cloud SQL para SQL Server

   Para origens do Cloud SQL para SQL Server, o Database Migration Service processa automaticamente o monitoramento das exportações de registros de transações. Não é necessário realizar outras ações depois de interromper as gravações na instância de origem. Você pode prosseguir com a promoção do job de migração.

   Fontes autogerenciadas ou do Amazon RDS

   Para origens autogerenciadas ou do Amazon RDS, é possível alcançar esse resultado realizando uma das seguintes ações:

   • Interrompa 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 registros de transações não processados para determinar quando o Database Migration Service terminará de processar esse arquivo.
   • Se quiser, faça upload de um arquivo de registro de transações com o sufixo .trn.final no nome. O Database Migration Service interrompe os carregamentos contínuos 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

   É possível promover um job de migração no Database Migration Service ou na página da instância de destino.

   No Database Migration Service:

   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, clique em Promover na barra de ferramentas.
      • Se quiser promover apenas bancos de dados específicos, selecione-os na guia Bancos de dados e clique em Promover.
   4. Na caixa de diálogo, verifique se não há erros e clique em Promover.

   Na instância de destino:

   1. No console do Google Cloud , acesse a página Instâncias do Cloud SQL.

      Acesse "Instâncias do Cloud SQL"

   2. Clique no nome de exibição da instância de destino da migração.

      A página de detalhes da instância é aberta.

   3. Na seção Migração, clique em Promover.
   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.

   • Opcional: o Database Migration Service migra todos os bancos de dados na origem por padrão. Se você quiser migrar apenas bancos de dados específicos, use a flag --databases-filter e especifique os identificadores como uma lista separada por vírgulas.

     Por exemplo: --databases-filter=my-business-database,my-other-database

     Depois, é possível editar os jobs de migração criados com o --database-filter flag usando o comando gcloud database-migration migration-jobs update.

   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 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:

   • 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 ver o status da operação em si.
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.