Предварительные требования
- Доступ к вашей исходной базе данных PostgreSQL с пользователем, у которого есть права на репликацию.
- Сервис ClickHouse Managed Postgres в качестве целевого сервиса для миграции. Если у вас его ещё нет, см. руководство по быстрому старту.
- На локальной машине должны быть установлены
pg_dumpиpsql. Оба входят в стандартный набор клиентских инструментов PostgreSQL.
Что нужно учитывать перед миграцией
- Распространение DDL: непрерывная репликация (CDC) фиксирует операции DML и
ADD COLUMN. Другие изменения DDL, такие какDROP COLUMNиALTER COLUMN, не распространяются и должны применяться вручную на целевой стороне.
1
Подключитесь к исходной базе данных
Откройте консоль ClickHouse Cloud и выберите свой сервис Managed Postgres.На левой боковой панели нажмите Источники данных.Нажмите Начать импорт.Заполните сведения о подключении к исходной базе данных PostgreSQL: хост, порт, имя пользователя, пароль и имя базы данных. Включите TLS, если это требуется для источника.Если для подключения к исходной базе данных требуется приватное соединение, выберите SSH-туннелирование и укажите необходимые параметры SSH. Это позволит миграции безопасно подключаться к базам данных без публичного доступа.Выберите способ ингестии:
- Начальная загрузка + CDC — копирует существующие данные, а затем поддерживает синхронизацию целевой системы с последующими изменениями.
- Только начальная загрузка — однократное копирование без дальнейшей репликации.
- Только CDC — пропускает первоначальное копирование и реплицирует только новые изменения, начиная с этого момента.
2
Экспортируйте схему базы данных
Мастер покажет команду Это создаст файл
pg_dump, уже заполненную сведениями о подключении к исходной базе данных. Выполните её в терминале:pg.sql в текущем каталоге.Нажмите Далее.3
Импортируйте схему в сервис Managed Postgres
Выберите базу данных назначения в раскрывающемся списке или нажмите Создать новую базу данных, чтобы создать её.Мастер покажет команду Нажмите Далее.
psql для применения дампа схемы к вашему сервису Managed Postgres. Выполните её в терминале:4
Настройте параметры ингестии
Укажите публикацию для логической репликации. Если оставить это поле пустым, публикация будет создана автоматически.Разверните Расширенные настройки репликации, чтобы настроить пропускную способность:
Нажмите Далее.
5
Выберите таблицы
Выберите таблицы, которые нужно реплицировать. Таблицы сгруппированы по схемам. Можно выбрать отдельные таблицы или развернуть схему, чтобы выбрать все таблицы в ней.Нажмите Создать миграцию.