Conferir e gerenciar jobs de migração

No console do Google Cloud , é possível realizar ações em massa para trabalhos de migração que têm o mesmo status. É possível realizar ações em um único job de migração no console Google Cloud e usando a Google Cloud CLI.

Você pode realizar qualquer uma das seguintes ações no seu job de migração:

Ação Descrição
Iniciar Iniciar jobs de migração que não estão no estado Em execução ou Iniciando. Consulte Status do job de migração.
Parar Interrompe um job de migração em execução. O movimento de dados é pausado. O status do job de migração muda primeiro para Stopping e depois para Stopped. É possível retomar, excluir ou promover um job de migração interrompido.

Em alguns casos, o banco de dados de origem precisa reter os dados até que você retome o job de migração. O período de armazenamento do banco de dados de origem pode ser limitado. Se o job de migração for pausado por mais tempo do que o período de armazenamento e depois for retomado, ele poderá falhar. Se isso acontecer, exclua ou reinicie o job de migração.

Retomar É possível retomar os jobs de migração interrompidos durante a fase de CDC. Quando você retoma um job de migração, o Database Migration Service retoma a replicação de eventos de mudança que se acumulam quando o job de migração é interrompido.
Reiniciar É possível reiniciar um job de migração que encontrou um erro e não pode continuar com a replicação de dados. O resultado da reinicialização de um job de migração depende do motivo da falha:
  • Se a replicação falhar devido a um erro em uma ou mais tabelas do banco de dados de origem ou de destino, reiniciar o job de migração vai excluir todos os dados das tabelas do banco de dados de destino incluídas no job de migração.
  • Reiniciar o job de migração não faz com que o Database Migration Service replique novas tabelas criadas no banco de dados de origem. Primeiro, é preciso adicionar as tabelas ao espaço de trabalho de conversão e converter o esquema delas.
Editar Consulte Editar um job de migração.
Excluir Um job de migração pode ser excluído. O resultado depende do status do job:
  • Se o job de migração estiver no status Completed, o registro será excluído da lista de jobs de migração.
  • Se o job de migração estiver em qualquer outro status, haverá uma opção para excluir a instância de destino associada do Cloud SQL.
Promover Durante o processo de migração, o banco de dados de destino é colocado em um estado somente leitura, totalmente gerenciado pelo Database Migration Service. Quando você quiser mudar o aplicativo para o banco de dados de destino migrado, a promoção do job de migração vai atualizar o banco de dados de destino para uma réplica independente. Consulte Promover uma migração.

Verificar um job de migração

  1. No console Google Cloud , acesse a página Jobs de migração.

    Acessar "Jobs de migração"

  2. Selecione um job de migração para ver a página de detalhes, que inclui:
    • Metadados do job de migração, como nome de exibição, ID, tipo de migração, perfil de conexão de origem, mecanismo do banco de dados de origem, destino, método de conectividade, data e hora de criação do job de migração e tempo de execução do job de migração.
    • Status e substatus do job de migração, além de outras informações. Diferentes ações estão disponíveis dependendo do status e do substatus do job de migração.

Iniciar um job de migração

Quando o job de migração estiver totalmente criado (ou seja, não estiver salvo em um estado de rascunho), você poderá iniciá-lo a qualquer momento para começar a migrar os dados.

Para iniciar um job de migração, siga estas etapas:

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

    A página de detalhes do job de migração é aberta.

  3. Clique em Iniciar.
  4. Na caixa de diálogo, clique em Iniciar.

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.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
start 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:

Interromper um job de migração

Você pode interromper um job de migração em execução a qualquer momento seguindo estas etapas:

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

    A página de detalhes do job de migração é aberta.

  3. Clique em Interromper.
  4. Na caixa de diálogo, clique em Parar.

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.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
stop 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: stop
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:

Retomar um job de migração

Para retomar um job de migração interrompido, siga estas etapas:

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

    A página de detalhes do job de migração é aberta.

  3. Clique em Retomar.
  4. Na caixa de diálogo, clique em Retomar.

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.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
resume 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: resume
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:

Reiniciar um job de migração

Para iniciar um job de migração, siga estas etapas:

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

    A página de detalhes do job de migração é aberta.

  3. Clique em Reiniciar.
  4. Na caixa de diálogo, clique em Reiniciar.

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 \
restart MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

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

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
restart 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: restart
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:

Atualizar um job de migração em rascunho

Para concluir a criação de um job de migração, siga estas etapas:

  1. No console Google Cloud , acesse a página Jobs de migração.

    Acessar "Jobs de migração"

  2. Na guia Rascunhos, clique no nome de exibição do job de migração que você quer terminar de criar.

    O assistente de criação de jobs de migração é aberto.

  3. Conclua a criação do job de migração. Consulte Criar um job de migração.

Editar um job de migração

É possível modificar as informações de configuração da origem, como as tabelas e os esquemas do banco de dados que o Database Migration Service vai migrar para o destino. O Database Migration Service usa essas informações de configuração para migrar os dados corretos da origem para o destino.

Adicionar ou remover objetos da migração

Para adicionar ou remover tabelas ou esquemas da migração, faça o seguinte:

  1. Acesse a página Jobs de migração no console Google Cloud .

    Acessar Jobs de migração

  2. Clique no nome de exibição do job de migração que você quer modificar. Uma página de visão geral aparece para o job de migração.

  3. Na seção Selecionar objetos para migrar, marque ou desmarque as caixas de seleção para mudar as tabelas e os esquemas na origem que o Database Migration Service vai migrar para o destino.

  4. Clique em Salvar ou Salvar e reiniciar.

    • Se você clicar em Salvar, o Database Migration Service vai mover apenas os dados históricos dos esquemas e tabelas selecionados.

    • Se você clicar em Salvar e reiniciar, o Database Migration Service vai iniciar a migração do começo, depois de limpar as tabelas selecionadas no destino.

Ajustar o número máximo de conexões simultâneas com o banco de dados de origem

É possível personalizar o número máximo de conexões simultâneas que o Database Migration Service pode fazer com sua instância de origem para a fase de despejo completo ou a fase de CDC.

  1. Acesse a página Jobs de migração no console Google Cloud .

    Acessar Jobs de migração

  2. Clique no nome de exibição do job de migração que você quer modificar. Uma página de visão geral aparece para o job de migração.

  3. Expanda a seção Personalizar configuração da fonte > Configurações de leitura da fonte.

  4. Nas seções Máximo de conexões simultâneas de despejo completo ou Máximo de conexões simultâneas do CDC, use o campo Personalizado para inserir o limite máximo de conexões para as fases de despejo completo ou CDC.

  5. Clique em Salvar ou Salvar e reiniciar.

Ajustar as configurações de configuração de destino

É possível personalizar o tempo limite da transação e o número máximo de conexões simultâneas para o banco de dados de destino:

  1. Acesse a página **Jobs de migração** no console Google Cloud .

    Acessar "Jobs de migração"

  2. Clique no nome de exibição do job de migração que você quer modificar.

    Uma página de visão geral aparece para o job de migração.

  3. Abra a seção Personalizar configuração de destino e modifique as seguintes configurações:
    Máximo de conexões de destino simultâneas

    Valor padrão: 128

    Valores permitidos: mínimo 2, máximo 256

    É possível personalizar o número máximo de conexões simultâneas que o Database Migration Service pode fazer com a instância de destino.

    O Database Migration Service ajusta o número de conexões para garantir o melhor desempenho dentro do limite de conexão fornecido. Aumentar o limite máximo de conexões pode melhorar a velocidade da migração, mas introduz uma carga adicional nos bancos de dados de destino.

    Tempo limite da transação

    Valor padrão: 30

    Valores permitidos: mínimo 30, máximo 300

    Durante o processo de migração, o Database Migration Service pode encontrar alguns problemas que causam o tempo limite da transação. É possível ajustar o número de segundos que o Database Migration Service aguarda a conclusão da transação antes de ser cancelada.

    As transações canceladas não causam falha no job de migração. O job de migração continua copiando dados, mas muda para o status Em execução com erros. É possível conferir os detalhes do job de migração para verificar quais problemas precisam ser resolvidos.

  4. Clique em Salvar ou Salvar e reiniciar.

Testar um job de migração

Antes de executar o job de migração, faça uma operação de teste para verificar se o Database Migration Service pode alcançar todas as entidades de origem e destino necessárias. No console Google Cloud , só é possível testar jobs de migração em rascunho criados no assistente de criação de jobs de migração (consulte Criar um job de migração).

Com CLI gcloud, é possível testar jobs de migração criados, mas ainda não iniciados.

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.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
verify 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: verify
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: