Вы можете перейти на ClickHouse Managed Postgres четырьмя разными способами. Выбор зависит от того, нужна ли вам непрерывная репликация, из какого источника вы мигрируете и какой простой приложение может выдержать при переключении.
| Метод | Непрерывная репликация (CDC) | Где выполняется | Лучше всего подходит для |
|---|---|---|---|
| ClickPipes | Да | консоль ClickHouse Cloud | Большинства миграций — пошаговый мастер с initial load и CDC из коробки |
| PeerDB | Да | Самоуправляемый (Docker) | Источников или сценариев, не поддерживаемых интерфейсом ClickPipes |
| pg_dump and pg_restore | Нет | Ваш локальный компьютер | Разовых переносов небольших или статичных наборов данных, где допустим простой |
| логическая репликация | Да | Исходный и целевой Postgres | Сценариев, где нужен прямой контроль над встроенной репликацией Postgres без сторонних инструментов |
ClickPipes
ClickPipes — рекомендуемый вариант для большинства миграций. Весь процесс выполняется прямо в консоли ClickHouse Cloud: она помогает подключиться к источнику, экспортировать и импортировать схему, а также запустить initial load с CDC или без него. Готовые коннекторы источников поддерживают Amazon RDS, Aurora, Supabase, Google Cloud SQL, Azure Flexible Server, Neon, Crunchy Bridge, TimescaleDB и любой стандартный экземпляр Postgres.
PeerDB
PeerDB — это самоуправляемый инструмент миграции, который запускается через Docker. Используйте его, если ваш источник или сценарий работы не подходят для мастера настройки ClickPipes — например, если вам нужно автоматизировать создание peer для множества баз данных или выполнять миграцию полностью внутри своей сети. PeerDB не переносит индексы, ограничения и триггеры автоматически; их нужно воссоздать на целевой стороне после переноса данных.
pg_dump and pg_restore
pg_dump и pg_restore создают снимок исходной базы и разворачивают его на целевой. Постоянной репликации нет, поэтому на время создания дампа и восстановления запись в исходную базу должна быть остановлена. Это подходящий вариант для небольших или статических наборов данных либо непроизводственных сред, где допустимо окно обслуживания.
Логическая репликация
Логическая репликация
использует встроенные в Postgres публикации и подписки для потоковой передачи изменений
из источника в целевую систему. Вы сами настраиваете wal_level, слоты репликации и
привилегию REPLICATION — без каких-либо сторонних инструментов-посредников.
Выбирайте этот вариант, если вам нужен полный контроль над механизмами репликации
или если в вашей среде нельзя использовать внешние инструменты миграции.
После миграции
Когда перенос данных уже идёт, воспользуйтесь проверкой данных, чтобы убедиться, что количество строк и содержимое в источнике и целевой системе совпадают, прежде чем переключать трафик приложения. В FAQ по миграциям описаны распространённые ошибки и шаги по восстановлению.
Миграция с Supabase
Если вы переходите с Supabase, пошаговое руководство см. в руководстве по миграции с Supabase на ClickHouse Managed Postgres.