Pré-requisitos
- Acesso ao seu banco de dados PostgreSQL de origem com um usuário que tenha privilégios de replicação. Siga o guia de configuração correspondente à sua origem:
- Amazon RDS Postgres
- Amazon Aurora Postgres
- Supabase Postgres
- Google Cloud SQL Postgres
- Azure Flexible Server for Postgres
- Neon Postgres
- Crunchy Bridge Postgres
- TimescaleDB
- Origem genérica do Postgres para qualquer outro provedor ou instância auto-hospedada
- Um serviço ClickHouse Managed Postgres como destino da migração. Se você ainda não tiver um, consulte o guia de início rápido.
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 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.
2
Exporte o esquema do seu banco de dados
O assistente exibe um comando Isso cria
pg_dump preenchido previamente com os detalhes da conexão de origem. Execute-o em um terminal: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 Clique em Próximo.
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 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.