Ver e gerenciar o progresso da migração

Para migrações heterogêneas do Oracle para o Cloud SQL para PostgreSQL, é possível monitorar e gerenciar o progresso da migração para todo o job de migração ou para tabelas individuais incluídas no job de migração.

Nesta página, descrevemos as ações que você pode realizar em cada nível. Para mais informações, consulte as seções Gerenciar jobs de migração e Gerenciar tabelas individuais.

Gerenciar jobs de migração

No console do Google Cloud , é possível realizar ações em massa para jobs de migração que têm o mesmo status. É possível realizar ações em um único job de migração no console do Google Cloud (no console do Database Migration Service ou diretamente na página da instância de destino do Cloud SQL) e usando a Google Cloud CLI.

É possível realizar qualquer uma das seguintes ações no job de migração:

Ação Descrição
Iniciar Inicie jobs de migração que não estejam no estado Em execução ou Iniciando. Consulte Status do job de migração.
Parar Interrompa um job de migração em execução. A movimentação de dados está pausada. 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.

Para migrações contínuas: 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 retenção 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, em seguida, for retomado, isso poderá causar uma falha no job. Se isso ocorrer, exclua ou reinicie o job de migração.

Retomar Quando você retoma um job de migração, o Database Migration Service retoma as operações de movimentação de dados:
  • Para migrações contínuas interrompidas durante a fase de CDC, o Database Migration Service retoma a replicação de eventos de alteração que se acumulam quando o job de migração é interrompido.
  • Para jobs de migração interrompidos durante a fase de despejo completo (uma migração única ou contínua), o Database Migration Service retoma a cópia dos dados que não foram copiados antes da interrupção da migração.
Reiniciar

É possível reiniciar um job de migração que encontrou um erro e não pode prosseguir 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 apagar 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, é necessário 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, será possível excluir a instância de destino associada do Cloud SQL para PostgreSQL.
Promover Durante o processo de migração, o banco de dados de destino é colocado em um estado somente leitura, em que é 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 do 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 de banco de dados de origem, destino, método de conectividade, data e hora em que o job de migração foi criado e há quanto tempo ele está em execução.
    • Status e substatus do job de migração e 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 dados.

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

Console

É possível iniciar um job de migração no console do Database Migration Service ou na página da instância de destino.

No console do Database Migration Service:

  1. No console do 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.

Na instância de destino:

  1. No console do Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acessar "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 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 pelo 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 pelo identificador da região em que o job de migraçã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 maneira assíncrona. Assim, esse comando retorna uma entidade Operation 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, consulte o objeto de operação retornado ou verifique o status do job de migração:

Interromper um job de migração

É possível interromper um job de migração em execução a qualquer momento seguindo estas etapas:

Console

É possível interromper um job de migração no console do Database Migration Service ou na página da instância de destino.

No console do Database Migration Service:

  1. No console do 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 interromper.

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

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

Na instância de destino:

  1. No console do Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acessar "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 Parar.
  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 pelo 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 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 \
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 maneira assíncrona. Assim, esse comando retorna uma entidade Operation 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, 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

É possível retomar um job de migração no console do Database Migration Service ou na página da instância de destino.

No console do Database Migration Service:

  1. No console do 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 retomar.

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

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

Na instância de destino:

  1. No console do Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acessar "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 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 pelo 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 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 \
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 maneira assíncrona. Assim, esse comando retorna uma entidade Operation 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, consulte o objeto de operação retornado ou verifique o status do job de migração:

Reiniciar um job de migração

Quando você reinicia um job de migração, o Database Migration Service limpa todos os dados das tabelas de destino. Os dados de origem não são afetados. O processo de migração é reiniciado, começando com o estágio de despejo completo.

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

Console

É possível reiniciar um job de migração no console do Database Migration Service ou na página da instância de destino.

No console do Database Migration Service:

  1. No console do 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.

Na instância de destino:

  1. No console do Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acessar "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 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 pelo 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 pelo identificador da região em que o job de migração está salvo.

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 maneira assíncrona. Assim, esse comando retorna uma entidade Operation 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, consulte o objeto de operação retornado ou verifique o status do job de migração:

Atualizar um job de migração de rascunho

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

  1. No console do 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 na origem 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 do 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 é exibida para o job de migração.

  3. Na seção Selecionar objetos para migrar, marque ou desmarque as caixas de seleção para alterar 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 das tabelas que você selecionar.

    • 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 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 a 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 do 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 é exibida para o job de migração.

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

  4. Nas seções Máximo de conexões simultâneas de despejo completo ou Máximo de conexões simultâneas de 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 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 do 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 é exibida 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 aumenta a carga 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 certos problemas que causam o tempo limite da transação. É possível ajustar o número de segundos que o Database Migration Service aguarda para que a transação seja concluída antes de ser cancelada.

    As transações canceladas não causam falhas no job de migração. O job de migração continua copiando dados, mas passa 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 um teste para verificar se o Database Migration Service pode acessar todas as entidades de origem e destino necessárias. No console do Google Cloud , só é possível testar jobs de migração de rascunho criados no assistente de criação de jobs de migração (consulte Criar um job de migração).

Com a 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 pelo 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 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 \
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 maneira assíncrona. Assim, esse comando retorna uma entidade Operation 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, consulte o objeto de operação retornado ou verifique o status do job de migração:

Gerenciar tabelas individuais

Para migrações heterogêneas do Oracle para o Cloud SQL para PostgreSQL, é possível conferir detalhes de status de tabelas específicas incluídas no job de migração.

Ver todas as tabelas em um job

Para ver detalhes de todas as tabelas em um job de migração, faça o seguinte:

Console

  1. No console do 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.

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

  3. Selecione a guia Tabelas e confira todas as tabelas incluídas no job. Também é possível usar filtros interativos para restringir a lista.

gcloud

Antes de usar os dados do comando abaixo, faça estas substituições:

  • MIGRATION_JOB_ID pelo 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 pelo identificador da região em que o job de migração está salvo.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud database-migration objects list \
  --migration-job=MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

gcloud database-migration objects list `
  --migration-job=MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

gcloud database-migration objects list ^
  --migration-job=MIGRATION_JOB_ID ^
  --region=REGION

Resultado

Esse comando retorna o estado, a fase e os detalhes do erro de todas as tabelas incluídas no job de migração, separados por linhas vazias. 

SOURCE_OBJECT: {'schema': 'Schema1', 'table': 'MyTable1', 'type': 'TABLE'}
STATE: RUNNING
PHASE: CDC
ERROR: {}

SOURCE_OBJECT: {'schema': 'Production', 'table': 'MyTable2', 'type': 'TABLE'}
STATE: RUNNING
PHASE: FULL_DUMP
ERROR:
  { 'code': 2,
    'details': [
        { '@type': 'type.googleapis.com/google.rpc.ErrorInfo',
          'domain': 'datamigration.googleapis.com',
          'metadata': {
            'errorMessage': '[DATABASE] error trying to write processed rows.
              Line: 2619 Position: 0 Schema: production Table: mytable2',
            'errorScope': 'NON_GLOBAL',
            'objectId': 'Production_MyTable2',
            'projectName': 'PROJECT_ID',
            'resourceName': 'MIGRATION_JOB_ID',
            'severity': 'ERROR'
          },
          'reason': 'DESTINATION_WRITE_ERROR'
        }
      ],
    'message': 'Encountered errors with your migration job table. Check the `details`
                  array for specific information on each issue.'
  }

Ver detalhes de uma única tabela

Para ver os detalhes da migração de uma única tabela, faça o seguinte:

Console

  1. No console do 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.

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

  3. Selecione a guia Tabelas e clique na tabela que você quer inspecionar. Também é possível usar filtros interativos para restringir a lista.

    O painel lateral de detalhes da tabela é aberto.

gcloud

Antes de usar os dados do comando abaixo, faça estas substituições:

  • MIGRATION_JOB_ID pelo 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 pelo identificador da região em que o job de migração está salvo.
  • SCHEMA_NAME pelo nome do esquema pai que contém a tabela.
  • TABLE_NAME pelo nome da tabela.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud database-migration objects lookup \
  --migration-job=MIGRATION_JOB_ID \
  --region=REGION \
  --schema=SCHEMA_NAME \
  --table=TABLE_NAME

Windows (PowerShell)

gcloud database-migration objects lookup `
  --migration-job=MIGRATION_JOB_ID `
  --region=REGION `
  --schema=SCHEMA_NAME `
  --table=TABLE_NAME

Windows (cmd.exe)

gcloud database-migration objects lookup ^
  --migration-job=MIGRATION_JOB_ID ^
  --region=REGION ^
  --schema=SCHEMA_NAME ^
  --table=TABLE_NAME

Resultado

Esse comando retorna o estado, a fase, o horário de criação e os detalhes do erro da tabela. A resposta inteira é uma string de várias linhas formatada em YAML. Exemplo: 

createTime: '2025-06-02T10:20:29.792832Z'
error:
  code: 2
  details:
  - '@type': type.googleapis.com/google.rpc.ErrorInfo
    domain: datamigration.googleapis.com
    metadata:
      errorMessage: '[DATABASE] error trying to write processed rows.
              Line: 2619 Position: 0 Schema: production Table: mytable2'
      errorScope: NON_GLOBAL
      objectId: Production_MyTable2
      projectName: PROJECT_ID
      resourceName: MIGRATION_JOB_ID
      severity: ERROR
    reason: DESTINATION_WRITE_ERROR
  message: Encountered errors with your migration job table. Check the `details` array
    for specific information on each issue.
name: projects/PROJECT_ID/locations/REGION/migrationJobs/MIGRATION_JOB_ID/objects/TABLE_UUID
phase: FULL_DUMP
sourceObject:
  schema: Production
  table: MyTable2
  type: TABLE
state: RUNNING