> ## 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.

# Синхронизация с ClickHouse с помощью WalShadow

> Репликация данных Postgres в ClickHouse с помощью WalShadow — нативного движка репликации, который читает данные напрямую из WAL PostgreSQL

Закрытая предварительная версия

`WalShadow` — это нативный движок репликации для ClickHouse Managed Postgres, который читает данные напрямую из журнала предзаписи PostgreSQL (Write-Ahead Log, WAL). Он оптимизирован для рабочих нагрузок с низкой задержкой и высокой пропускной способностью и обеспечивает отставание репликации из Postgres в ClickHouse менее одной секунды. Разработка ведётся открыто в репозитории [ClickHouse/walshadow](https://github.com/ClickHouse/walshadow).

`WalShadow` — один из двух методов репликации, доступных в разделе **Sync to ClickHouse**. Второй, [ClickPipes](https://clickhouse.com/docs/ru/cloud/managed-postgres/clickpipes.md), представляет собой полностью управляемый конвейер данных. Выбирайте `WalShadow`, если вам нужна минимальная задержка и минимальные накладные расходы на репликацию.

Если `WalShadow` доступен для вашего сервиса, на странице **Overview** отображается баннер **закрытая предварительная версия**. Нажмите **Configure WalShadow**, чтобы начать работу.

![Страница обзора сервиса Postgres с баннером закрытой предварительной версии WalShadow и ссылками Learn more и Configure WalShadow](https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/overview-banner.webp?fit=max\&auto=format\&n=1IUPNo0kgSNuyelj\&q=85\&s=868266fa6f2514dcdbdaef9696e53327)

> [!NOTE]
>
> Прежде чем продолжить, убедитесь, что ваш сервис Postgres доступен для ClickHouse. `WalShadow` подключается к целевому сервису ClickHouse напрямую, поэтому вам понадобятся пользователь ClickHouse и пароль с разрешением на создание баз данных и таблиц.

Чтобы настроить репликацию, нажмите **Sync to ClickHouse** на боковой панели вашего экземпляра Postgres, а затем — **Replicate data in ClickHouse**.

![Страница Sync to ClickHouse с методами репликации ClickPipes и WalShadow](https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/sync-landing.webp?fit=max\&auto=format\&n=1IUPNo0kgSNuyelj\&q=85\&s=5932d900f2bd6438fa1ce524a3bc7979)

**1. Выберите движок репликации**

Выберите **WalShadow** в качестве движка репликации, затем нажмите **Next**.

![Шаг выбора движка репликации с вариантами ClickPipes и WalShadow, выбран WalShadow](https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/select-engine.webp?fit=max\&auto=format\&n=1IUPNo0kgSNuyelj\&q=85\&s=4c8138e85677394c695cc11a9455730b)

**2. Настройте сервис репликации**

Заполните настройки репликации:

* **ClickHouse service**: выберите существующий сервис ClickHouse или создайте новый
* **Postgres database**: выберите исходную базу данных, из которой будет выполняться репликация, или создайте новую
* **Replication method**: выберите один из вариантов:
  * **Initial load + CDC**: импортировать существующие данные и поддерживать таблицы в актуальном состоянии по мере поступления новых изменений (рекомендуется)
  * **Initial load only**: разовый импорт существующих данных без дальнейших обновлений
  * **CDC only**: пропустить первоначальный импорт и фиксировать только новые изменения

![Шаг настройки сервиса репликации с параметрами сервиса ClickHouse, базы данных Postgres и метода репликации](https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/configure-service.webp?fit=max\&auto=format\&n=1IUPNo0kgSNuyelj\&q=85\&s=df2a577cb52e60eefc1fca5f887492f6)

Нажмите **Next**, чтобы продолжить.

**3. Выберите таблицы для репликации**

Выберите целевую базу данных и укажите, какие таблицы репликовать:

* **Destination database**: выберите существующую базу данных ClickHouse или создайте новую
* **Tables**: разверните каждую схему и выберите отдельные таблицы либо включите переключатель **Select all tables**. Для каждой таблицы можно задать **Destination table name** и изменить **Column settings**.
* **ClickHouse user** и **ClickHouse password**: `WalShadow` подключается к целевому сервису ClickHouse напрямую, поэтому ему нужны учётные данные с разрешением на создание целевой базы данных и таблиц.

![Шаг выбора таблиц с выбором схемы и таблиц, именами целевых таблиц и учётными данными ClickHouse](https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/select-tables.webp?fit=max\&auto=format\&n=1IUPNo0kgSNuyelj\&q=85\&s=03d6e3f80a706c99f2082408ba3e7832)

Нажмите **Replicate data to ClickHouse**, чтобы начать репликацию.

**4. Мониторинг WalShadow**

После запуска репликации `WalShadow` появляется на странице **Sync to ClickHouse**. Пока конвейер разворачивается и готовится первоначальная загрузка, его статус — **Creating**.

![Страница Sync to ClickHouse, на которой WalShadow находится в состоянии Creating](https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/walshadow-creating.webp?fit=max\&auto=format\&n=1IUPNo0kgSNuyelj\&q=85\&s=caead405c1e77d03f529034584be0289)

После завершения развёртывания статус меняется на **Running**. На странице отображаются актуальные метрики репликации:

* **Status**: текущее состояние конвейера (например, `Running`)
* **Rows synced**: общее количество строк, реплицированных в ClickHouse
* **Backfills pending**: количество таблиц, ожидающих первоначальной загрузки
* **Lag**: объём данных WAL, которые ещё предстоит применить
* **Lag time**: насколько пункт назначения сейчас отстаёт от Postgres
* **Uptime**: как долго работает конвейер
* **Last updated**: когда метрики обновлялись последний раз

![Страница Sync to ClickHouse, на которой WalShadow находится в состоянии Running с метриками синхронизированных строк, отставания и времени работы](https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/walshadow-running.webp?fit=max\&auto=format\&n=1IUPNo0kgSNuyelj\&q=85\&s=2bb2a79206e83ac4ef801f944b97602f)

## Ограничения

Несколько моментов, которые следует учитывать, пока `WalShadow` находится в статусе закрытой предварительной версии:

* Пока поддерживается только один `WalShadow` на сервис Postgres.
* Операции и более детальные метрики запланированы в roadmap.
