Promover um job de migração

Para migrações contínuas, inicie o processo de promoção depois que for a hora de mover 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 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ções foram replicados para a instância de destino do Cloud SQL para SQL Server.

   Fontes do Cloud SQL para SQL Server

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

   Fontes autogerenciadas ou do Amazon RDS

   Para fontes 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 registro de transações não processados para determinar quando o Database Migration Service terminar de processar esse arquivo.
   • Opcionalmente, é possível fazer upload de um arquivo de registro de transações cujo nome termine em .trn.final sufixo. O Database Migration Service interrompe cargas contínuas quando detecta um arquivo de backup cujo nome corresponde à .trn.final convenção de sufixo.

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

3. Realize 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 Google Cloud console, 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, na barra de ferramentas, clique em Promover.
      • Se você 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 Google Cloud console, 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 com o identificador do job de migração.

     Se você não souber o identificador, use o gcloud database-migration migration-jobs list comando 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 deles como uma lista separada por vírgulas.

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

     É possível editar jobs de migração criados com a --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 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 bem-sucedida, consulte o objeto de operação retornado ou verifique o status do job de migração:

   • Use o gcloud database-migration migration-jobs describe comando 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. O aplicativo agora pode ser conectado à instância do Cloud SQL, e o job de migração pode ser excluído com segurança.