> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Интеграция с ClickHouse

> Реплицируйте данные Postgres в ClickHouse с помощью встроенных средств CDC

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Beta feature. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        Learn more.
                    </a>
                </u>
            </span>
        </div>;
};

Каждый экземпляр Managed Postgres имеет встроенные возможности CDC для любого из ваших сервисов ClickHouse. Это позволяет перенести часть или все данные из вашего экземпляра Postgres в ClickHouse, а изменения данных в Postgres будут непрерывно, почти в реальном времени, отражаться в ClickHouse. В основе этой возможности лежит [ClickPipes](/ru/integrations/clickpipes/home).

Чтобы воспользоваться этой функцией, нажмите **ClickHouse Integration** на боковой панели вашего экземпляра Postgres.

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/qT0j4CNmQubVqREl/images/managed-postgres/clickhouse-integration-intro.png?fit=max&auto=format&n=qT0j4CNmQubVqREl&q=85&s=725f49ffaae6f1cc5666e66a8cb2e900" alt="Страница ClickHouse integration с пунктом интеграции на боковой панели" size="md" border width="2682" height="1274" data-path="images/managed-postgres/clickhouse-integration-intro.png" />

<Note>
  Перед продолжением убедитесь, что ваш сервис Postgres доступен сервису ClickPipes. Обычно это так по умолчанию, но если вы ограничили доступ по IP, вам может потребоваться разрешить доступ для некоторых исходных IP-адресов из [этого](/ru/integrations/clickpipes/home#list-of-static-ips) списка в зависимости от региона, где расположен ваш **сервис ClickHouse**.
</Note>

Нажмите **Replicate data in ClickHouse**, чтобы начать настройку ClickPipe.

<Steps>
  <Step>
    ## Настройте сервис репликации

    Заполните параметры репликации:

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

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/qT0j4CNmQubVqREl/images/managed-postgres/replication-service-step.png?fit=max&auto=format&n=qT0j4CNmQubVqREl&q=85&s=dfdb6548307e14cbab3bd99f014ae918" alt="Настройка сервиса репликации с именем интеграции, целевым сервисом и параметрами метода репликации" size="md" border width="2076" height="1290" data-path="images/managed-postgres/replication-service-step.png" />

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

  <Step>
    ## Выберите таблицы для репликации

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

    * **Destination database**: выберите существующую базу данных ClickHouse или создайте новую
    * **Prefix default destination table names with schema name**: добавляет имя схемы Postgres в качестве префикса, чтобы избежать конфликтов имён
    * **Preserve NULL values from source**: сохраняет значения NULL вместо преобразования в значения по умолчанию
    * **Remove deleted rows during merges**: для таблиц [ReplacingMergeTree](/ru/reference/engines/table-engines/mergetree-family/replacingmergetree) физически удаляет помеченные как удалённые строки во время фоновых слияний

    Раскройте схемы и выберите отдельные таблицы для репликации. Вы также можете настроить имена целевых таблиц и параметры столбцов.

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/qT0j4CNmQubVqREl/images/managed-postgres/select-tables-step.png?fit=max&auto=format&n=qT0j4CNmQubVqREl&q=85&s=bc98e7efa4ba22f0ee00d452e158daa2" alt="Шаг выбора таблиц с выбором базы данных, параметрами репликации и средством выбора таблиц, сгруппированным по схемам" size="md" border width="2454" height="1804" data-path="images/managed-postgres/select-tables-step.png" />

    Нажмите **Replicate data to ClickHouse**, чтобы запустить репликацию.
  </Step>

  <Step>
    ## Отслеживайте ClickPipe

    После запуска ClickPipe он появится в том же меню. Создание начального снимка всех данных может занять некоторое время в зависимости от размера ваших таблиц.

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/qT0j4CNmQubVqREl/images/managed-postgres/integration-running.png?fit=max&auto=format&n=qT0j4CNmQubVqREl&q=85&s=9a94e816b4507d6cc67414342cf27a6a" alt="Список ClickHouse integration с работающим ClickPipe, его целевым сервисом и статусом" size="md" border width="2518" height="622" data-path="images/managed-postgres/integration-running.png" />

    Нажмите на имя интеграции, чтобы просмотреть подробный status, отслеживать прогресс, просматривать ошибки и управлять ClickPipe. См. [Lifecycle of a Postgres ClickPipe](/ru/integrations/clickpipes/postgres/lifecycle), чтобы понять, в каких состояниях может находиться ваш ClickPipe.
  </Step>
</Steps>