Veja e faça a gestão de trabalhos de migração

Na Google Cloud consola, pode realizar ações em massa para tarefas de migração que tenham o mesmo estado. Pode realizar ações numa única tarefa de migração na Google Cloud consola e através da CLI Google Cloud.

Pode realizar qualquer uma das seguintes ações na tarefa de migração:

Ação Descrição
Iniciar Iniciar tarefas de migração que não estejam no estado Em execução ou A iniciar. Consulte os Estados das tarefas de migração.
Parar Parar uma tarefa de migração em execução. A movimentação de dados está em pausa. O estado da tarefa de migração é alterado primeiro para Stopping e, em seguida, para Stopped. Pode retomar, eliminar ou promover uma tarefa de migração interrompida.

Em alguns casos, a base de dados de origem tem de reter os dados até retomar a tarefa de migração. O período de retenção da base de dados de origem pode ser limitado. Se a tarefa de migração for pausada durante mais tempo do que o período de retenção e, em seguida, for retomada, pode falhar. Se isto ocorrer, elimine ou reinicie a tarefa de migração.

Retomar Pode retomar as tarefas de migração paradas durante a fase de CDC. Quando retoma uma tarefa de migração, o serviço de migração de bases de dados retoma a replicação de eventos de alteração que se acumulam quando a tarefa de migração é interrompida.
Reiniciar Pode reiniciar uma tarefa de migração que encontrou um erro e não pode prosseguir com a replicação de dados. O resultado do reinício de uma tarefa de migração depende do motivo da falha:
  • Se a replicação tiver falhado devido a um erro numa ou mais tabelas da base de dados de origem ou de destino, o reinício da tarefa de migração limpa todos os dados das tabelas da base de dados de destino incluídas na tarefa de migração.
  • O reinício da tarefa de migração não faz com que o serviço de migração de bases de dados replique novas tabelas que criou na base de dados de origem. Primeiro, tem de adicionar as tabelas ao espaço de trabalho de conversão e converter o respetivo esquema.
Editar Consulte Edite uma tarefa de migração.
Eliminar É possível eliminar uma tarefa de migração. O resultado depende do estado da tarefa:
  • Se a tarefa de migração estiver no estado Completed, o registo é eliminado da lista de tarefas de migração.
  • Se a tarefa de migração estiver em qualquer outro estado, existe uma opção para escolher eliminar a instância do Cloud SQL de destino associada.
Promova Durante o processo de migração, a base de dados de destino é colocada num estado de só leitura, em que é totalmente gerida pelo Database Migration Service. Quando quiser mudar a sua aplicação para a base de dados de destino migrada, a promoção da tarefa de migração atualiza a base de dados de destino para uma réplica autónoma. Consulte Promova uma migração.

Reveja uma tarefa de migração

  1. Na Google Cloud consola, aceda à página Tarefas de migração.

    Aceda a Tarefas de migração

  2. Selecione uma tarefa de migração para ver a respetiva página de detalhes, que inclui:
    • Metadados da tarefa de migração, como o nome a apresentar, o ID, o tipo de migração, o perfil de ligação de origem, o motor da base de dados de origem, o destino, o método de conetividade, a data e a hora em que a tarefa de migração foi criada e o tempo de execução da tarefa de migração.
    • Estado e subestado da tarefa de migração, bem como informações adicionais. Estão disponíveis diferentes ações consoante o estado e o subestado da tarefa de migração.

Inicie uma tarefa de migração

Quando a tarefa de migração estiver totalmente criada (ou seja, não estiver guardada como rascunho), pode iniciá-la em qualquer altura para começar a migrar dados.

Para iniciar uma tarefa de migração, siga estes passos:

Consola

  1. Na Google Cloud consola, aceda à página Tarefas de migração.

    Aceda a Tarefas de migração

  2. No separador Tarefas, clique no nome a apresentar da tarefa de migração que quer iniciar.

    É apresentada a página de detalhes da tarefa de migração.

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

gcloud

Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

  • MIGRATION_JOB_ID com o identificador da tarefa de migração.

    Se não souber o identificador, pode usar o comando gcloud database-migration migration-jobs list para listar todas as tarefas de migração numa determinada região e ver os respetivos identificadores.

  • REGION com o identificador da região onde o seu perfil de associação está guardado.

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. Como tal, este comando devolve 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 ver se a operação foi bem-sucedida, pode consultar o objeto de operação devolvido ou verificar o estado da tarefa de migração:

Pare uma tarefa de migração

Pode parar uma tarefa de migração em execução em qualquer altura através dos seguintes passos:

Consola

  1. Na Google Cloud consola, aceda à página Tarefas de migração.

    Aceda a Tarefas de migração

  2. No separador Tarefas, clique no nome a apresentar da tarefa de migração que quer iniciar.

    É apresentada a página de detalhes da tarefa de migração.

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

gcloud

Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

  • MIGRATION_JOB_ID com o identificador da tarefa de migração.

    Se não souber o identificador, pode usar o comando gcloud database-migration migration-jobs list para listar todas as tarefas de migração numa determinada região e ver os respetivos identificadores.

  • REGION com o identificador da região onde o seu perfil de associação está guardado.

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. Como tal, este comando devolve 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 ver se a operação foi bem-sucedida, pode consultar o objeto de operação devolvido ou verificar o estado da tarefa de migração:

Retome uma tarefa de migração

Pode retomar uma tarefa de migração interrompida seguindo estes passos:

Consola

  1. Na Google Cloud consola, aceda à página Tarefas de migração.

    Aceda a Tarefas de migração

  2. No separador Tarefas, clique no nome a apresentar da tarefa de migração que quer iniciar.

    É apresentada a página de detalhes da tarefa de migração.

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

gcloud

Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

  • MIGRATION_JOB_ID com o identificador da tarefa de migração.

    Se não souber o identificador, pode usar o comando gcloud database-migration migration-jobs list para listar todas as tarefas de migração numa determinada região e ver os respetivos identificadores.

  • REGION com o identificador da região onde o seu perfil de associação está guardado.

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. Como tal, este comando devolve 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 ver se a operação foi bem-sucedida, pode consultar o objeto de operação devolvido ou verificar o estado da tarefa de migração:

Reinicie uma tarefa de migração

Para iniciar uma tarefa de migração, siga estes passos:

Consola

  1. Na Google Cloud consola, aceda à página Tarefas de migração.

    Aceda a Tarefas de migração

  2. No separador Tarefas, clique no nome a apresentar da tarefa de migração que quer reiniciar.

    É apresentada a página de detalhes da tarefa de migração.

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

gcloud

Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

  • MIGRATION_JOB_ID com o identificador da tarefa de migração.

    Se não souber o identificador, pode usar o comando gcloud database-migration migration-jobs list para listar todas as tarefas de migração numa determinada região e ver os respetivos identificadores.

  • REGION com o identificador da região onde o seu perfil de associação está guardado.

  • Opcional: o serviço de migração de base de dados migra todas as bases de dados na sua origem por predefinição. Se quiser migrar apenas bases de dados específicas, use a flag --databases-filter e especifique os respetivos identificadores como uma lista separada por vírgulas.

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

    Pode editar posteriormente as tarefas de migração que criou com o comando --database-filter flag através do 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. Como tal, este comando devolve 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 ver se a operação foi bem-sucedida, pode consultar o objeto de operação devolvido ou verificar o estado da tarefa de migração:

Atualize uma tarefa de migração de rascunho

Para terminar a criação de uma tarefa de migração, siga estes passos:

  1. Na Google Cloud consola, aceda à página Tarefas de migração.

    Aceda a Tarefas de migração

  2. No separador Rascunhos, clique no nome a apresentar da tarefa de migração que quer terminar de criar.

    É aberto o assistente de criação de tarefas de migração.

  3. Conclua a criação da tarefa de migração. Consulte o artigo Crie uma tarefa de migração.

Edite uma tarefa de migração

Pode modificar as informações de configuração da origem, como as tabelas e os esquemas da base de dados na origem que o serviço de migração de bases de dados vai migrar para o destino. O serviço de migração de bases de dados usa estas informações de configuração para migrar os dados corretos da origem para o destino.

Adicione ou remova objetos da migração

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

  1. Aceda à página Tarefas de migração na Google Cloud consola.

    Aceda às tarefas de migração

  2. Clique no nome a apresentar da tarefa de migração que quer modificar. É apresentada uma página de vista geral da tarefa de migração.

  3. Na secção Selecionar objetos a migrar, selecione ou desmarque as caixas de verificação para alterar as tabelas e os esquemas na origem que o serviço de migração de bases de dados vai migrar para o destino.

  4. Clique em Guardar ou Guardar e reiniciar.

    • Se clicar em Guardar, o Serviço de migração de bases de dados move apenas os dados do histórico para os esquemas e as tabelas que selecionar.

    • Se clicar em Guardar e reiniciar, o serviço de migração de bases de dados inicia a migração desde o início, após limpar todas as tabelas que selecionar no destino.

Ajuste o número máximo de ligações simultâneas à base de dados de origem

Pode personalizar o número máximo de ligações simultâneas que o serviço de migração de bases de dados pode estabelecer à sua instância de origem para a fase de descarga completa ou a fase de CDC.

  1. Aceda à página Tarefas de migração na Google Cloud consola.

    Aceda às tarefas de migração

  2. Clique no nome a apresentar da tarefa de migração que quer modificar. É apresentada uma página de vista geral da tarefa de migração.

  3. Expanda a secção Personalizar configuração da origem > Definições de leitura da origem.

  4. Nas secções Máximo de ligações de despejo completo simultâneas ou Máximo de ligações de CDC simultâneas, use o campo Personalizado para introduzir o limite máximo de ligações para as fases de despejo completo ou CDC.

  5. Clique em Guardar ou Guardar e reiniciar.

Ajuste as definições de configuração do destino

Pode personalizar o limite de tempo da transação e o número máximo de ligações simultâneas para a base de dados de destino:

  1. Aceda à página **Tarefas de migração** na Google Cloud consola.

    Aceda a Tarefas de migração

  2. Clique no nome a apresentar da tarefa de migração que quer modificar.

    É apresentada uma página de vista geral da tarefa de migração.

  3. Expanda a secção Personalizar configuração do destino e modifique as seguintes definições:
    Número máximo de associações de destinos simultâneas

    Valor predefinido: 128

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

    Pode personalizar o número máximo de ligações simultâneas que o serviço de migração de bases de dados pode estabelecer à instância de destino.

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

    Tempo limite da transação

    Valor predefinido: 30

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

    Durante o processo de migração, o Database Migration Service pode encontrar determinados problemas que fazem com que a transação exceda o limite de tempo. Pode ajustar o número de segundos que o serviço de migração de bases de dados aguarda pela conclusão da transação antes de ser cancelada.

    As transações canceladas não fazem com que a tarefa de migração falhe. A tarefa de migração continua a copiar dados, mas passa para o estado Em execução com erros. Pode ver os detalhes da tarefa de migração para verificar que problemas têm de ser resolvidos.

  4. Clique em Guardar ou Guardar e reiniciar.

Teste uma tarefa de migração

Antes de executar a tarefa de migração, pode realizar uma operação de teste para verificar se o Database Migration Service consegue alcançar todas as entidades de origem e destino necessárias. Na Google Cloud consola, só pode testar tarefas de migração de rascunho que criar no assistente de criação de tarefas de migração (consulte Criar uma tarefa de migração).

Com a CLI gcloud, pode testar tarefas de migração criadas, mas ainda não iniciadas.

Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

  • MIGRATION_JOB_ID com o identificador da tarefa de migração.

    Se não souber o identificador, pode usar o comando gcloud database-migration migration-jobs list para listar todas as tarefas de migração numa determinada região e ver os respetivos identificadores.

  • REGION com o identificador da região onde o seu perfil de associação está guardado.

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. Como tal, este comando devolve 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 ver se a operação foi bem-sucedida, pode consultar o objeto de operação devolvido ou verificar o estado da tarefa de migração: