Skip to main content
O ClickHouse Cloud agora oferece o ClickPipes para migrar seu banco de dados PostgreSQL externo para um serviço Managed Postgres. Essa integração nativa oferece uma experiência simplificada para conectar-se ao banco de dados de origem, exportar o esquema, importá-lo para o Managed Postgres e configurar a replicação contínua.

Pré-requisitos

Considerações antes da migração

  • Propagação de DDL: a replicação contínua (CDC) captura operações de DML e ADD COLUMN. Outras alterações de DDL, como DROP COLUMN e ALTER COLUMN, não são propagadas e devem ser aplicadas manualmente no banco de destino.
Se você encontrar problemas durante a migração, consulte o FAQ de Migrações do Managed Postgres para ver os erros e as soluções mais comuns.
1

Conecte-se ao seu banco de dados de origem

Abra o console do ClickHouse Cloud e selecione seu serviço Managed Postgres.Na barra lateral esquerda, clique em Fontes de dados.Clique em Iniciar importação.Preencha os detalhes da conexão com seu banco de dados PostgreSQL de origem: host, porta, nome de usuário, senha e nome do banco de dados. Ative TLS se a origem exigir.Se você precisar de uma conexão privada com seu banco de dados de origem, poderá optar por tunelamento SSH e fornecer os detalhes de SSH necessários. Isso permite que a migração se conecte com segurança a bancos de dados que não estão acessíveis publicamente.Escolha um método de ingestão:
  • Carga inicial + CDC — copia os dados existentes e depois mantém o destino sincronizado com as alterações em andamento.
  • Somente carga inicial — cópia única, sem replicação contínua.
  • Somente CDC — pula a cópia inicial e replica apenas as novas alterações a partir deste ponto.
Clique em Próximo.
2

Exporte o esquema do seu banco de dados

O assistente exibe um comando pg_dump preenchido previamente com os detalhes da conexão de origem. Execute-o em um terminal:
Isso cria pg.sql no diretório atual.Clique em Próximo.
3

Importe o esquema para seu serviço Managed Postgres

Selecione o banco de dados de destino na lista suspensa ou clique em Criar um novo banco de dados para provisionar um.O assistente exibe um comando psql para aplicar o dump do esquema ao seu serviço Managed Postgres. Execute-o em um terminal:
Clique em Próximo.
4

Configure as definições de ingestão

Especifique a publication a ser usada na replicação lógica. Se você deixar esse campo em branco, uma publication será criada automaticamente.Expanda Configurações avançadas de replicação para ajustar a taxa de transferência:Clique em Próximo.
5

Selecione as tabelas

Selecione as tabelas que você deseja replicar. As tabelas são agrupadas por esquema. Selecione tabelas individuais ou expanda um esquema para selecionar todas.Clique em Criar migração.

Monitore a migração

Após criar a migração, ela aparecerá listada em Fontes de dados com o status Em execução. Clique na migração para abrir a tela de detalhes. A aba Tabelas mostra o progresso da carga inicial de cada tabela, incluindo linhas processadas, partições e o tempo médio por partição. A aba Métricas mostra a defasagem da replicação e a taxa de transferência quando o CDC começar.

Tarefas pós-migração

Quando a carga inicial for concluída e, se estiver usando CDC, a defasagem da replicação estiver próxima de zero: Valide a contagem de linhas. Faça uma verificação pontual das tabelas críticas na origem e no destino antes de redirecionar o tráfego:
Interrompa as escritas na origem. Pause as escritas da aplicação. Para impor o modo somente leitura durante a transição:
Confirme se a replicação está sincronizada. Compare a linha mais recente na origem e no destino:
Redefina as sequências. Alinhe-as aos valores máximos atuais de cada tabela:
Redirecione o tráfego da aplicação. Aponte leituras e gravações para seu serviço Managed Postgres e monitore erros, violações de restrições e a integridade da replicação. Faça a limpeza. Depois de redirecionar o tráfego e confirmar que o novo serviço está funcionando corretamente, exclua a migração em fonte de dados. Se você usou CDC, exclua o slot de replicação da origem para liberar recursos:

Próximos passos

Última modificação em 24 de julho de 2026