Set up docs MCPVocê pode migrar para o ClickHouse Managed Postgres de quatro maneiras diferentes. A melhor opção depende de você precisar de replicação contínua, da origem da migração e de quanto tempo de indisponibilidade sua aplicação pode tolerar durante a transição.
| Método | Replicação contínua (CDC) | Onde é executado | Mais indicado para |
|---|---|---|---|
| ClickPipes | Sim | console do ClickHouse Cloud | A maioria das migrações — assistente guiado com carga inicial e CDC prontos para uso |
| PeerDB | Sim | Auto-hospedado (Docker) | Origens ou fluxos de trabalho não cobertos pela UI do ClickPipes |
| pg_dump and pg_restore | Não | Sua máquina local | Migrações pontuais de conjuntos de dados pequenos ou estáticos, quando a indisponibilidade é aceitável |
| replicação lógica | Sim | Postgres de origem e destino | Controle direto sobre a replicação nativa do Postgres, sem ferramentas de terceiros |
ClickPipes
ClickPipes é a opção recomendada para a maioria das migrações. Ele funciona inteiramente no console do ClickHouse Cloud e orienta você na conexão com a origem, na exportação e importação do schema e no início de uma carga inicial com ou sem CDC. Conectores de origem pré-configurados dão suporte a Amazon RDS, Aurora, Supabase, Google Cloud SQL, Azure Flexible Server, Neon, Crunchy Bridge, TimescaleDB e qualquer instância genérica do Postgres.
PeerDB
PeerDB é uma ferramenta de migração auto-hospedada que você executa via Docker. Use-a quando sua origem ou fluxo de trabalho não se adequar ao assistente do ClickPipes — por exemplo, quando você precisar automatizar por script a criação de peers em vários bancos de dados ou executar a migração inteiramente dentro da sua própria rede. O PeerDB não migra índices, restrições nem triggers automaticamente; você os recria no destino depois que os dados chegam.
pg_dump and pg_restore
pg_dump and pg_restore capturam um snapshot da origem e o restauram no destino. Não há replicação contínua, então as operações de escrita devem ser interrompidas na origem durante todo o período do dump e da restauração. Essa é a escolha certa para conjuntos de dados pequenos ou estáticos, ou ambientes não produtivos em que uma janela de manutenção seja aceitável.
Replicação lógica
A replicação lógica
usa publicações e assinaturas nativas do Postgres para transmitir alterações da
origem ao destino. Você mesmo configura wal_level, slots de replicação e
o privilégio REPLICATION — nenhuma ferramenta de terceiros intermedeia o
processo. Escolha esse caminho quando quiser controle total sobre os mecanismos
de replicação ou quando as regras do seu ambiente não permitirem ferramentas de
migração externas.
Após a migração
Quando os dados estiverem sendo transferidos, use a validação de dados para confirmar que as contagens de linhas e o conteúdo correspondem entre a origem e o destino antes de redirecionar o tráfego da aplicação. O FAQ sobre migrações aborda erros comuns e as etapas de recuperação.
Migração do Supabase
Se você estiver migrando do Supabase, consulte o guia de migração do Supabase para o ClickHouse Managed Postgres para conferir um passo a passo.