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 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. 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.
  3. Aguarde até que a métrica de atraso na replicação esteja em zero ou perto de zero. Isso significa que o job de migração processou todas as mudanças pendentes.

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

  4. Realize a ação de promoção:

    Console

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

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

        A caixa de diálogo "Promover job de migração" será 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 será exibida.

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

    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 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:
  5. 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.
  6. O aplicativo agora pode ser conectado à instância do Cloud SQL, e o job de migração pode ser excluído com segurança.

A seguir