Veja e faça a gestão do progresso da migração

Para migrações heterogéneas do Oracle para o Cloud SQL para PostgreSQL, pode monitorizar e gerir o progresso da migração para toda a tarefa de migração ou para tabelas individuais incluídas na tarefa de migração.

Esta página descreve as ações que pode realizar em cada nível. Para mais informações, consulte as secções Faça a gestão de tarefas de migração e Faça a gestão de tabelas individuais.

Faça a gestão das tarefas 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 para PostgreSQL de destino associada.
Promova Durante o processo de migração, a base de dados de destino é colocada num estado de 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 parada 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

Quando reinicia uma tarefa de migração, o Serviço de migração de bases de dados 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 pela fase de despejo completo.

Para reiniciar 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 a sua tarefa de migração está guardada.

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

Faça a gestão de tabelas individuais

Para migrações heterogéneas do Oracle para o Cloud SQL para PostgreSQL, pode ver detalhes do estado de tabelas específicas incluídas na sua tarefa de migração.

Veja todas as tabelas num trabalho

Para ver os detalhes de todas as tabelas num trabalho de migração, faça o seguinte:

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 sua tarefa de migração.

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

  3. Selecione o separador Tabelas e veja todas as tabelas incluídas no seu trabalho. Também pode usar filtros interativos para restringir a lista.

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 a sua tarefa de migração está guardada.

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

Este comando devolve o estado, a fase e os detalhes do erro de todas as tabelas incluídas na tarefa de migração separadas 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.'
  }

Veja os detalhes de uma única tabela

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

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 sua tarefa de migração.

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

  3. Selecione o separador Tabelas e clique na tabela que quer inspecionar. Também pode usar filtros interativos para restringir a lista.

    É aberto o painel lateral de detalhes da tabela.

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 a sua tarefa de migração está guardada.
  • SCHEMA_NAME com o nome do esquema principal que contém a sua tabela.
  • TABLE_NAME com o 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

Este comando devolve o estado, a fase, a hora de criação e os detalhes dos erros da sua tabela. Toda a resposta é uma string de várias linhas formatada em YAML. Por 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