Skip to main content
ClickHouse Cloud включает встроенный мастер импорта, который переносит вашу внешнюю базу данных PostgreSQL в сервис Managed Postgres. Этот мастер выполняет подключение к источнику, экспорт и импорт схемы, настройку репликации и выбор таблиц в рамках пяти пошаговых этапов.

Предварительные требования

  • Доступ к вашей исходной базе данных 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

Выберите таблицы

Выберите таблицы, которые нужно реплицировать. Таблицы сгруппированы по схемам. Можно выбрать отдельные таблицы или развернуть схему, чтобы выбрать все таблицы в ней.Нажмите Создать миграцию.

Отслеживание миграции

После создания миграции вы увидите её в разделе Источники данных со статусом Running. Нажмите на миграцию, чтобы открыть подробное представление. На вкладке Tables отображается ход начальной загрузки для каждой таблицы, включая количество обработанных строк, партиции и среднее время на партицию. На вкладке Metrics после начала CDC отображаются отставание репликации и пропускная способность.

Действия после миграции

После завершения начальной загрузки и, если используется CDC, когда задержка репликации становится близкой к нулю: Проверьте число строк. Выборочно проверьте критически важные таблицы в исходной и целевой системах перед переключением трафика:
Остановите запись в источнике. Приостановите запись со стороны приложения. Чтобы перевести систему в режим только для чтения на время переключения:
Убедитесь, что репликация синхронизировалась. Сравните последнюю строку в источнике и целевой базе данных:
Сбросьте последовательности. Синхронизируйте последовательности с текущими максимальными значениями в каждой таблице:
Переведите трафик приложения. Направьте операции чтения и записи на ваш сервис Managed Postgres и отслеживайте ошибки, нарушения ограничений и состояние репликации. Выполните очистку. После перевода трафика и подтверждения, что новый сервис работает нормально, удалите миграцию из раздела Источники данных. Если вы использовали CDC, удалите слот репликации на источнике, чтобы освободить ресурсы:

Следующие шаги

Последнее изменение 24 июля 2026 г.