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

# Управление синхронизацией MySQL ClickPipe

> Документация по управлению синхронизацией в MySQL ClickPipe

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

В этом документе описано, как управлять синхронизацией ClickPipe для MySQL, когда ClickPipe находится в **режиме CDC (Running)**.

<div id="overview">
  ## Обзор
</div>

Архитектура ClickPipes для баз данных состоит из двух параллельных процессов: получения данных из исходной базы данных и отправки данных в целевую базу данных. Процесс получения управляется конфигурацией синхронизации, которая определяет, как часто нужно получать данные и какой объем данных нужно получать за один раз. Под «за один раз» имеется в виду один батч, поскольку ClickPipe получает и отправляет данные батчами.

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

<div id="interval">
  ### Интервал синхронизации
</div>

Интервал синхронизации пайпа — это промежуток времени (в секундах), в течение которого ClickPipe получает записи из базы данных-источника. Время, необходимое для отправки уже полученных данных в ClickHouse, в этот интервал не входит.

Значение по умолчанию — **1 минута**.
Интервал синхронизации можно задать любым положительным целым числом, но рекомендуется устанавливать его не менее 10 секунд.

<div id="batch-size">
  ### Размер батча при извлечении
</div>

Размер батча при извлечении — это количество записей, которое ClickPipe извлекает из исходной базы данных за один батч. Под записями здесь имеются в виду вставки, обновления и удаления в таблицах, входящих в этот пайп.

По умолчанию используется **100 000** записей.
Безопасный максимум — 10 миллионов.

<div id="transactions">
  ### Исключение: длительные транзакции в исходной базе данных
</div>

Когда в исходной базе данных запускается транзакция, ClickPipe ждёт, пока не получит её COMMIT, прежде чем продолжить работу. Это **имеет приоритет над** и интервалом синхронизации, и размером батча при извлечении.

<div id="configuring">
  ### Настройка параметров синхронизации
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/postgres/create_sync_settings.webp?fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=b14b8d19b8fdc96b83dfb887fce1d309" alt="Создание параметров синхронизации" size="md" width="902" height="654" data-path="images/integrations/data-ingestion/clickpipes/postgres/create_sync_settings.webp" />

При редактировании существующего ClickPipe перейдите на вкладку **Settings** этого пайпа, приостановите его, а затем нажмите **Configure**:

<Image img="https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.webp?fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=5ce6aa32c7a2048990a090e0807898a7" alt="Кнопка редактирования параметров синхронизации" size="md" width="933" height="417" data-path="images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.webp" />

Откроется выдвижная панель с параметрами синхронизации, где можно изменить интервал синхронизации и размер батча при извлечении:

<Image img="https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/postgres/sync_settings_edit.webp?fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=bbcbb06b57adc484a9653b37b30b410b" alt="Редактирование параметров синхронизации" size="md" width="598" height="588" data-path="images/integrations/data-ingestion/clickpipes/postgres/sync_settings_edit.webp" />

<div id="monitoring">
  ### Мониторинг работы управления синхронизацией
</div>

В таблице **CDC Syncs** на вкладке **Metrics** в ClickPipe можно увидеть, сколько времени занимает каждый батч. Обратите внимание, что длительность здесь включает время отправки, а также время ожидания: если новые строки не поступают, ClickPipe ждёт, и это время тоже входит в длительность.

<Image img="https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/postgres/cdc_syncs.webp?fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=3f119ad79fac51d12694abea4b26e48a" alt="Таблица CDC Syncs" size="md" width="2428" height="626" data-path="images/integrations/data-ingestion/clickpipes/postgres/cdc_syncs.webp" />
