Data Transmission Service:Migrar dados do PolarDB for PostgreSQL para um banco de dados Oracle autogerenciado

Limitações impeditivas

Resolva estes pontos antes de iniciar a migração. Ignorá-los pode causar falha na tarefa ou torná-la irrecuperável.

• Sem migração de schema. Crie todos os schemas e tabelas de destino no Oracle antes de configurar a tarefa de migração.

• Logical Replication Slot Failover obrigatório para migração incremental. Caso o cluster PolarDB for PostgreSQL de origem não suporte esse recurso (por exemplo, se o Database Engine for PostgreSQL 14), um failover de alta disponibilidade (HA) durante a migração poderá causar falha irrecuperável na instância de migração.

• Limite de 256 MB por linha na migração incremental. Se uma única linha ultrapassar 256 MB após uma alteração incremental, a instância de migração falhará sem possibilidade de recuperação. Para retomar, reconfigure a instância.

• Chave primária ou índice único não nulo obrigatórios. As tabelas a serem migradas devem possuir chave primária ou índice único não nulo.

• Operações DDL proibidas durante a migração completa. Comandos DDL que alterem a estrutura do banco ou das tabelas causam falha na tarefa.

• Foreign keys e triggers no banco de destino. Desative foreign keys e triggers no banco Oracle de destino antes da migração. Se permanecerem ativos, a tarefa poderá falhar.

• Configuração REPLICA IDENTITY para migração incremental. Antes de gravar dados nas tabelas migradas, execute o comando abaixo no banco de origem. Faça isso em horários de baixa demanda e evite operações concorrentes de bloqueio de tabela para prevenir deadlocks.

  ALTER TABLE schema.table REPLICA IDENTITY FULL;

  Execute este comando nos seguintes cenários: quando a instância for executada pela primeira vez; quando o objeto de migração for um schema e uma nova tabela for criada nele; ou quando o objeto de migração for um schema e uma tabela existente for recriada com o comando RENAME. Se você pular o item de pré-verificação relacionado, o DTS executa automaticamente esse comando durante a inicialização da instância.

• Tabelas particionadas. Inclua tanto a tabela pai quanto todas as tabelas filhas como objetos de migração. No PostgreSQL, tabelas pai de partições não armazenam dados diretamente — todo o conteúdo reside nas tabelas filhas. Omitir as tabelas filhas gera inconsistência de dados.

Limitações gerais

• Cada tarefa migra apenas um banco de dados. Configure uma tarefa separada para cada banco que deseja migrar.

• O DTS não suporta a migração de tabelas da extensão TimescaleDB, tabelas com herança entre schemas ou tabelas com índices únicos baseados em expressões.

• Schemas criados pela instalação de plugins não podem ser migrados e não aparecem no console durante a configuração da tarefa.

• Operações de atualização e exclusão em cascata no banco de origem podem gerar inconsistência de dados no destino.

• Como a migração completa executa operações INSERT concorrentes, o espaço ocupado pelas tabelas no destino pode ficar maior que na origem após a conclusão.

• O DTS valida o conteúdo dos dados, mas não metadados como sequences. Valide sequences e outros metadados separadamente.

• Transações longas combinadas com tarefas de migração incremental provocam acúmulo de write-ahead logs (WAL), podendo esgotar o espaço em disco do banco de origem.

Gerenciamento de slots de replicação

Durante a migração incremental, o DTS cria um slot de replicação com o prefixo dts_sync_ no banco de origem. Esse slot retém logs incrementais dos últimos 15 minutos. Quando a migração falha ou a instância é liberada, o DTS tenta limpar o slot automaticamente.

A limpeza automática falha nos casos abaixo, exigindo remoção manual do slot para evitar acúmulo em disco:

• A senha da conta do banco de origem é alterada durante a migração.

• O endereço IP do DTS é removido da lista de permissões de endereços IP do banco de origem durante a migração.

• Ocorre um failover no banco de origem — faça login no banco secundário para limpar o slot.

Tabelas temporárias do DTS

O DTS cria as seguintes tabelas temporárias no banco de origem durante a migração. Não as exclua, pois isso causa falha na tarefa. O DTS as remove automaticamente quando a instância de migração é liberada.

public.dts_pg_class, public.dts_pg_attribute, public.dts_pg_type, public.dts_pg_enum, public.dts_postgres_heartbeat, public.dts_ddl_command, public.dts_args_session, public.aliyun_dts_instance

Etapa 1: Abrir a página de configuração da tarefa de migração

Use um dos pontos de entrada abaixo.

Pelo console do DTS:

1. Faça login no console do Data Transmission Service (DTS).

2. No painel de navegação à esquerda, clique em Data Migration.

3. No canto superior esquerdo, selecione a região onde a instância de migração estará localizada.

4. Clique em Create Task.

Pelo console do DMS:

A navegação real pode variar conforme o modo e o layout do console do DMS. Para detalhes, consulte Simple mode console e Customize the layout and style of the DMS console .

1. Faça login no console do Data Management (DMS).

2. Na barra de menu superior, escolha Data + AI > Data Transmission (DTS) > Data Migration.

3. À direita de Data Migration Tasks, selecione a região de destino.

4. Clique em Create Task.

Etapa 2: Configurar bancos de dados de origem e destino

Na página de configuração da tarefa, defina Task Name com um nome descritivo para facilitar a identificação. O nome não precisa ser único.

Banco de dados de origem (PolarDB for PostgreSQL):

Banco de dados de destino (Oracle):

Após concluir a configuração, clique em Test Connectivity and Proceed. Na caixa de diálogo CIDR Blocks of DTS Servers, clique em Test Connectivity.

Certifique-se de que os intervalos de endereços IP dos servidores DTS foram adicionados às configurações de segurança dos bancos de origem e destino. Consulte Add DTS server IP addresses to a whitelist .

Etapa 3: Configurar objetos de migração

Na página Configure Objects, defina os seguintes parâmetros:

Clique em Next: Advanced Settings.

Etapa 4: Configurar definições avançadas

Etapa 5: Executar a pré-verificação

Clique em Next: Save Task Settings and Precheck.

Para visualizar os parâmetros da API desta configuração, passe o mouse sobre o botão Next: Save Task Settings and Precheck e clique em Preview OpenAPI parameters .

O DTS executa uma pré-verificação antes de iniciar a migração. Se a pré-verificação falhar:

• Clique em View Details ao lado do item com falha, corrija o problema e execute a pré-verificação novamente.

• Para avisos que podem ser ignorados, clique em Confirm Alert Details > Ignore > OK > Precheck Again. Ignorar avisos pode causar inconsistência de dados.

Etapa 6: Adquirir a instância e iniciar a migração

1. Quando a Success Rate atingir 100%, clique em Next: Purchase Instance.

2. Na página Purchase, selecione o grupo de recursos e a classe da instância. A classe da instância influencia a velocidade da migração. Consulte Data migration link specifications.

3. Leia e aceite os Data Transmission Service (Pay-as-you-go) Service Terms.

4. Clique em Buy and Start e depois em OK na caixa de diálogo de confirmação.

A tarefa de migração aparece na lista Data Migration Tasks. Tarefas de migração completa param automaticamente ao terminar (status: Completed). Tarefas de migração incremental continuam em execução (status: Running) até que você as interrompa.