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_dumpepsqlinstalados 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, comoDROP COLUMNeALTER 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.
2
Exporte o esquema do seu banco de dados
O assistente exibe um comando Isso cria
pg_dump pré-preenchido com os detalhes de conexão da sua origem. Execute-o em um terminal: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 Clique em Next.
psql para aplicar o dump do esquema ao seu serviço Managed Postgres. Execute-o em um terminal: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.