Promover um job de migração

Para migrações contínuas, é possível iniciar 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 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 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.

    Para isso, faça uma das seguintes ações:

    • Pare os uploads automáticos de arquivos de backup ou faça upload do último arquivo de registro de transações. Monitore o tamanho dos backups de log de transação 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 cujo nome termine com o sufixo .trn.final. O Database Migration Service interrompe os carregamentos contínuos quando detecta um arquivo de backup cujo nome corresponde à convenção de sufixo .trn.final.

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

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

    Console

    1. No console 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.
    3. A página de detalhes do job de migração é aberta.

    4. 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 "Promover 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 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 vai aparecer.

    5. 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 comando gcloud database-migration migration-jobs list para listar todos os jobs de migração em uma determinada região e ver os identificadores deles.

    • REGION com o identificador da região em que o perfil de conexão está salvo.
    • Opcional: por padrão, o Database Migration Service migra todos os bancos de dados na sua origem. 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

      É possível editar depois 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

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