> ## Documentation Index > Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Миграция в Managed Postgres с помощью ClickHouse Cloud > Узнайте, как перенести базу данных PostgreSQL в ClickHouse Managed Postgres с помощью встроенного мастера импорта в разделе «Источники данных» ClickHouse Cloud. export const Image = ({img, alt, size = "lg"}) => { const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg"; return
{alt}
; }; export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => { if (link) { return Бета ; } return
Возможность в статусе бета.  Подробнее.
; }; ClickHouse Cloud включает встроенный мастер импорта, который переносит вашу внешнюю базу данных PostgreSQL в сервис Managed Postgres. Этот мастер выполняет подключение к источнику, экспорт и импорт схемы, настройку репликации и выбор таблиц в рамках пяти пошаговых этапов.
## Предварительные требования
* Доступ к вашей исходной базе данных PostgreSQL с пользователем, у которого есть права на репликацию. * Сервис ClickHouse Managed Postgres в качестве целевого сервиса для миграции. Если у вас его ещё нет, см. [руководство по быстрому старту](/docs/ru/products/managed-postgres/quickstart). * На локальной машине должны быть установлены `pg_dump` и `psql`. Оба входят в стандартный набор клиентских инструментов PostgreSQL.
## Что нужно учитывать перед миграцией
* **Распространение DDL**: непрерывная репликация (CDC) фиксирует операции DML и `ADD COLUMN`. Другие изменения DDL, такие как `DROP COLUMN` и `ALTER COLUMN`, не распространяются и должны применяться вручную на целевой стороне. Откройте [консоль ClickHouse Cloud](https://clickhouse.cloud) и выберите свой сервис Managed Postgres. Карточка сервиса Managed Postgres в списке сервисов ClickHouse Cloud На левой боковой панели нажмите **Источники данных**. Пункт "Источники данных" на боковой панели сервиса Managed Postgres Нажмите **Начать импорт**. Страница "Источники данных" с кнопкой "Начать импорт" Заполните сведения о подключении к исходной базе данных PostgreSQL: хост, порт, имя пользователя, пароль и имя базы данных. Включите **TLS**, если это требуется для источника. Если для подключения к исходной базе данных требуется приватное соединение, выберите **SSH-туннелирование** и укажите необходимые параметры SSH. Это позволит миграции безопасно подключаться к базам данных без публичного доступа. Выберите способ ингестии: * **Начальная загрузка + CDC** — копирует существующие данные, а затем поддерживает синхронизацию целевой системы с последующими изменениями. * **Только начальная загрузка** — однократное копирование без дальнейшей репликации. * **Только CDC** — пропускает первоначальное копирование и реплицирует только новые изменения, начиная с этого момента. Шаг 1: форма подключения к исходной базе данных с вариантами способа ингестии Нажмите **Далее**. Мастер покажет команду `pg_dump`, уже заполненную сведениями о подключении к исходной базе данных. Выполните её в терминале: Шаг 2: команда pg_dump для экспорта схемы ```shell theme={null} pg_dump \ -h \ -U \ -d \ --schema-only \ -f pg.sql ``` Это создаст файл `pg.sql` в текущем каталоге. Вывод терминала после выполнения pg_dump Нажмите **Далее**. Выберите базу данных назначения в раскрывающемся списке или нажмите **Создать новую базу данных**, чтобы создать её. Мастер покажет команду `psql` для применения дампа схемы к вашему сервису Managed Postgres. Выполните её в терминале: Шаг 3: команда psql для импорта схемы ```shell theme={null} psql \ -h \ -p 5432 \ -U \ -d \ -f pg.sql ``` Вывод терминала после выполнения импорта схемы через psql Нажмите **Далее**. Укажите публикацию для логической репликации. Если оставить это поле пустым, публикация будет создана автоматически. Разверните **Расширенные настройки репликации**, чтобы настроить пропускную способность: | Настройка | По умолчанию | Описание | | ----------------------------------------------------------- | ------------ | ------------------------------------------------------------ | | Интервал синхронизации (секунды) | 10 | Как часто опрашивается слот репликации | | Параллельные потоки для начальной загрузки | 4 | Количество потоков для этапа массового копирования | | Размер батча при получении | 100,000 | Количество строк, получаемых за один батч репликации | | Количество строк в снимке на партицию | 100000 | Размер партиции для снимков больших таблиц | | Количество таблиц, для которых снимки создаются параллельно | 1 | Количество таблиц, для которых одновременно создаётся снимок | Шаг 4: форма настроек ингестии с публикацией и расширенными параметрами репликации Нажмите **Далее**. Выберите таблицы, которые нужно реплицировать. Таблицы сгруппированы по схемам. Можно выбрать отдельные таблицы или развернуть схему, чтобы выбрать все таблицы в ней. Шаг 5: выбор таблиц, сгруппированных по схеме, с кнопкой Create migration Нажмите **Создать миграцию**.
## Отслеживание миграции
После создания миграции вы увидите её в разделе **Источники данных** со статусом **Running**. Список в разделе Источники данных, показывающий выполняющуюся миграцию Нажмите на миграцию, чтобы открыть подробное представление. На вкладке **Tables** отображается ход начальной загрузки для каждой таблицы, включая количество обработанных строк, партиции и среднее время на партицию. На вкладке **Metrics** после начала CDC отображаются отставание репликации и пропускная способность. Подробное представление миграции, показывающее статистику начальной загрузки по каждой таблице
## Действия после миграции
После завершения начальной загрузки и, если используется CDC, когда задержка репликации становится близкой к нулю: **Проверьте число строк.** Выборочно проверьте критически важные таблицы в исходной и целевой системах перед переключением трафика: ```sql theme={null} SELECT COUNT(*) FROM public.orders; ``` **Остановите запись в источнике.** Приостановите запись со стороны приложения. Чтобы перевести систему в режим только для чтения на время переключения: ```sql theme={null} ALTER DATABASE SET default_transaction_read_only = on; ``` **Убедитесь, что репликация синхронизировалась.** Сравните последнюю строку в источнике и целевой базе данных: ```sql theme={null} -- Выполните на источнике и целевой базе данных SELECT MAX(id), MAX(updated_at) FROM public.orders; ``` **Сбросьте последовательности.** Синхронизируйте последовательности с текущими максимальными значениями в каждой таблице: ```sql theme={null} DO $$ DECLARE r RECORD; BEGIN FOR r IN SELECT n.nspname AS schema_name, c.relname AS table_name, a.attname AS column_name, pg_get_serial_sequence(format('%I.%I', n.nspname, c.relname), a.attname) AS seq_name FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace JOIN pg_attribute a ON a.attrelid = c.oid WHERE c.relkind = 'r' AND a.attnum > 0 AND NOT a.attisdropped AND n.nspname NOT IN ('pg_catalog', 'information_schema') LOOP IF r.seq_name IS NOT NULL THEN EXECUTE format( 'SELECT setval(%L, COALESCE((SELECT MAX(%I) FROM %I.%I), 0) + 1, false)', r.seq_name, r.column_name, r.schema_name, r.table_name ); END IF; END LOOP; END $$; ``` **Переведите трафик приложения.** Направьте операции чтения и записи на ваш сервис Managed Postgres и отслеживайте ошибки, нарушения ограничений и состояние репликации. **Выполните очистку.** После перевода трафика и подтверждения, что новый сервис работает нормально, удалите миграцию из раздела **Источники данных**. Если вы использовали CDC, удалите слот репликации на источнике, чтобы освободить ресурсы: ```sql theme={null} SELECT pg_drop_replication_slot(''); ```
## Следующие шаги
* [Краткое руководство по Managed Postgres](/docs/ru/products/managed-postgres/quickstart) * [Сведения о подключении к Managed Postgres](/docs/ru/products/managed-postgres/connection) * [FAQ по ClickPipes Postgres](/docs/ru/integrations/clickpipes/postgres/faq)