Skip to main content
O ClickHouse Cloud inclui um assistente integrado de importação que migra seu banco de dados PostgreSQL externo para um serviço Managed Postgres. O assistente gerencia a conexão com a origem, a exportação e importação do esquema, as configurações de replicação e a seleção de tabelas em cinco etapas guiadas.

Pré-requisitos

  • Acesso ao seu banco de dados PostgreSQL de origem com um usuário que tenha privilégios de replicação.
  • Um serviço ClickHouse Managed Postgres como destino da migração. Se você ainda não tiver um, consulte o quickstart.
  • pg_dump e psql instalados na sua máquina local. Ambos vêm com as ferramentas padrão do cliente PostgreSQL.

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 precisam ser aplicadas manualmente no destino.
1

Conecte-se ao 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 Start import.Preencha os detalhes de conexão do 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 precisar de uma conexão privada com o banco de dados de origem, você pode optar por SSH tunneling e fornecer os detalhes necessários de SSH. Isso permite que a migração se conecte com segurança a bancos de dados que não sã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 contínuas.
  • Somente carga inicial — cópia única, sem replicação contínua.
  • Somente CDC — pula a cópia inicial e replica apenas novas alterações a partir deste ponto.
Clique em Next.
2

Exporte o esquema do seu banco de dados

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

Importe o esquema para o seu serviço Managed Postgres

Selecione o banco de dados de destino na lista suspensa ou clique em Create a new database 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 Next.
4

Configure as definições de ingestão

Especifique a publication a ser usada para replicação lógica. Se você deixar esse campo em branco, uma publication será criada automaticamente.Expanda Advanced replication settings para ajustar a taxa de transferência:Clique em Next.
5

Selecione as tabelas

Selecione as tabelas que deseja replicar. As tabelas são agrupadas por esquema. Selecione tabelas individuais ou expanda um esquema para escolher todas.Clique em Create migration.

Monitore a migração

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

Tarefas pós-migração

Quando a carga inicial estiver 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 gravações no sistema de origem. Pause as gravações do aplicativo. Para forçar o modo somente leitura durante a transição:
Confirme se a replicação está sincronizada. Compare a linha mais recente da origem e do destino:
Redefina as sequências. Alinhe as sequências aos valores máximos atuais em cada tabela:
Direcione o tráfego da aplicação. Aponte leituras e gravações para o seu serviço Managed Postgres e monitore erros, violações de restrições e a integridade da replicação. Limpeza. Depois de concluir a transição e confirmar que o novo serviço está funcionando corretamente, exclua a migração em Fontes de dados. Se você usou CDC, remova o slot de replicação da origem para liberar recursos:

Próximas etapas

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