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

> Пошаговое руководство по настройке Cloud SQL for MySQL как источника для ClickPipes

# Руководство по настройке Cloud SQL for MySQL как источника для ClickPipes

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

Это пошаговое руководство по настройке вашего экземпляра Cloud SQL for MySQL для репликации данных через ClickPipe для MySQL.

<div id="enable-binlog-retention-gcp">
  ## Включить хранение бинарного лога
</div>

Бинарный лог — это набор файлов журнала, содержащих сведения об изменениях данных на сервере MySQL, и эти файлы необходимы для репликации.

<div id="enable-binlog-logging-gcp">
  ### Включите бинарное логирование через PITR
</div>

Функция PITR определяет, включено ли бинарное логирование для MySQL в Google Cloud. Это можно настроить в консоли Cloud: откройте экземпляр Cloud SQL и прокрутите страницу вниз до показанного ниже раздела.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/6SF9X3meQepxG_IK/images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-pitr.png?fit=max&auto=format&n=6SF9X3meQepxG_IK&q=85&s=44940bd301c5566d8bc19cb0ad18d850" alt="Включение PITR в Cloud SQL" size="lg" border width="1622" height="1800" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-pitr.png" />

Рекомендуется задать достаточно большое значение в зависимости от сценария репликации.

Если это ещё не настроено, обязательно задайте следующие параметры в разделе флагов базы данных, отредактировав Cloud SQL:

1. `binlog_expire_logs_seconds` — значение >= `86400` (1 день).
2. `binlog_row_metadata` — значение `FULL`
3. `binlog_row_image` — значение `FULL`

Для этого нажмите кнопку `Edit` в правом верхнем углу страницы обзора экземпляра.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/6SF9X3meQepxG_IK/images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-edit-button.png?fit=max&auto=format&n=6SF9X3meQepxG_IK&q=85&s=71d52f52f16cbc223ae6c73330e650a9" alt="Кнопка Edit в GCP MySQL" size="lg" border width="2174" height="570" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-edit-button.png" />

Затем прокрутите вниз до раздела `Flags` и добавьте указанные выше флаги.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/6SF9X3meQepxG_IK/images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-flags.png?fit=max&auto=format&n=6SF9X3meQepxG_IK&q=85&s=d6057c4733a929a0e7e3f5e5559ebb80" alt="Настройка флагов binlog в GCP" size="lg" border width="1174" height="1810" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-flags.png" />

<div id="configure-database-user-gcp">
  ## Настройте пользователя базы данных
</div>

Подключитесь к своему экземпляру Cloud SQL MySQL от имени пользователя root и выполните следующие команды:

1. Создайте выделенного пользователя для ClickPipes:

   ```sql theme={null}
   CREATE USER 'clickpipes_user'@'host' IDENTIFIED BY 'some-password';
   ```

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

   ```sql theme={null}
   GRANT SELECT ON `clickpipes`.* TO 'clickpipes_user'@'host';
   ```

3. Выдайте пользователю разрешения на репликацию:

   ```sql theme={null}
   GRANT REPLICATION CLIENT ON *.* TO 'clickpipes_user'@'%';
   GRANT REPLICATION SLAVE ON *.* TO 'clickpipes_user'@'%';
   ```

<div id="configure-network-access-gcp-mysql">
  ## Настройка сетевого доступа
</div>

Если вы хотите ограничить доступ к своему экземпляру Cloud SQL, добавьте [указанные в документации статические NAT IP-адреса](/ru/integrations/clickpipes/home#list-of-static-ips) в список разрешённых IP-адресов экземпляра Cloud SQL MySQL.
Это можно сделать, либо отредактировав экземпляр, либо перейдя на вкладку `Connections` на боковой панели в консоли Cloud.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/6SF9X3meQepxG_IK/images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-ip.png?fit=max&auto=format&n=6SF9X3meQepxG_IK&q=85&s=cfe583e190e8f7556cc1002b10352308" alt="Разрешённые IP-адреса в GCP MySQL" size="lg" border width="1110" height="1598" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-ip.png" />

<div id="download-root-ca-certificate-gcp-mysql">
  ## Скачайте и используйте корневой CA‑сертификат
</div>

Чтобы подключиться к экземпляру Cloud SQL, необходимо скачать корневой CA‑сертификат.

1. Перейдите к своему экземпляру Cloud SQL в консоли Cloud.
2. На боковой панели выберите `Connections`.
3. Откройте вкладку `Security`.
4. В разделе `Manage server CA certificates` нажмите расположенную внизу кнопку `DOWNLOAD CERTIFICATES`.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/6SF9X3meQepxG_IK/images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-cert.png?fit=max&auto=format&n=6SF9X3meQepxG_IK&q=85&s=43491ecf9dfb2acce2d2dfe3bd522cd7" alt="Загрузка сертификата GCP MySQL" size="lg" border width="1584" height="1098" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-cert.png" />

5. В интерфейсе ClickPipes загрузите скачанный сертификат при создании нового ClickPipe для MySQL.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/6SF9X3meQepxG_IK/images/integrations/data-ingestion/clickpipes/mysql/source/gcp/rootca.png?fit=max&auto=format&n=6SF9X3meQepxG_IK&q=85&s=0b7e0d5f92cc567228c04f8f849127a4" alt="Использование сертификата GCP MySQL" size="lg" border width="1636" height="1170" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/gcp/rootca.png" />
