> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-revert-104359-revert-104251-parquet-single.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. > Пошаговое руководство по настройке Amazon Aurora MySQL в качестве источника для ClickPipes # Руководство по настройке источника Aurora MySQL export const Image = ({img, alt, size = "lg"}) => { const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg"; return
{alt}
; }; Это пошаговое руководство показывает, как настроить Amazon Aurora MySQL для репликации данных в ClickHouse Cloud с помощью [MySQL ClickPipe](/ru/integrations/clickpipes/mysql/index). Ответы на часто задаваемые вопросы о CDC в MySQL см. на [странице с часто задаваемыми вопросами по MySQL](/ru/integrations/clickpipes/mysql/faq).
## Включение хранения бинарного лога
Бинарный лог — это набор файлов журналов, содержащих сведения об изменениях данных, внесенных в экземпляр сервера MySQL, и файлы бинарного лога необходимы для репликации. Чтобы настроить хранение бинарного лога в Aurora MySQL, необходимо [включить бинарное логирование](#enable-binlog-logging) и [увеличить интервал хранения binlog](#binlog-retention-interval). Функция автоматического резервного копирования определяет, включено ли бинарное логирование для MySQL. Автоматическое резервное копирование можно настроить для вашего экземпляра в RDS Console, перейдя в **Modify** > **Additional configuration** > **Backup** и установив флажок **Enable automated backups** (если он еще не установлен). Включение автоматического резервного копирования в Aurora Мы рекомендуем установить для **Backup retention period** достаточно большое значение в зависимости от сценария использования репликации. Если ClickPipes попытается возобновить репликацию, а нужные файлы binlog уже будут удалены из-за настроенного периода хранения binlog, ClickPipe перейдет в состояние ошибки, и потребуется повторная синхронизация. По умолчанию Aurora MySQL удаляет бинарный лог при первой возможности (то есть использует *lazy purging*). Мы рекомендуем увеличить интервал хранения binlog как минимум до **72 часов**, чтобы файлы бинарного лога оставались доступными для репликации в случае сбоев. Чтобы задать интервал хранения бинарного лога ([`binlog retention hours`](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/mysql-stored-proc-configuring.html#mysql_rds_set_configuration-usage-notes.binlog-retention-hours)), используйте процедуру [`mysql.rds_set_configuration`](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/mysql-stored-proc-configuring.html#mysql_rds_set_configuration): [//]: # "ПРИМЕЧАНИЕ: Большинство провайдеров CDC рекомендуют максимальный период хранения для Aurora RDS (7 дней/168 часов). Поскольку это влияет на использование дискового пространства, мы рекомендуем минимальное значение 3 дня/72 часа." ```text theme={null} mysql=> call mysql.rds_set_configuration('binlog retention hours', 72); ``` Если этот параметр не задан или для него установлен слишком малый интервал, это может привести к пропускам в бинарных логах и нарушить способность ClickPipes возобновлять репликацию.
## Настройка параметров binlog
Группу параметров можно найти, выбрав свой экземпляр MySQL в RDS Console, а затем открыв вкладку **Configuration**. Если у вас кластер MySQL, указанные ниже параметры находятся в группе параметров [DB cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.CreatingCluster.html), а не в группе параметров экземпляра DB. Где найти группу параметров в Aurora
Нажмите ссылку группы параметров — откроется её отдельная страница. В правом верхнем углу должна быть кнопка **Edit**. Редактирование группы параметров
Необходимо задать следующие значения параметров: 1. `binlog_format` — `ROW`. Формат binlog: ROW 2. `binlog_row_metadata` — `FULL`. Метаданные строк binlog 3. `binlog_row_image` — `FULL`. Образ строки binlog
Затем нажмите **Save Changes** в правом верхнем углу. Чтобы изменения вступили в силу, может потребоваться перезагрузить экземпляр. Понять, что это необходимо, можно по метке `Pending reboot` рядом со ссылкой на группу параметров на вкладке **Configuration** экземпляра Aurora.
## Включите режим GTID (рекомендуется)
MySQL ClickPipe также поддерживает репликацию без режима GTID. Однако для более высокой производительности и упрощения диагностики рекомендуется включить режим GTID. [Глобальные идентификаторы транзакций (GTID)](https://dev.mysql.com/doc/refman/8.0/en/replication-gtids.html) — это уникальные идентификаторы, назначаемые каждой зафиксированной транзакции в MySQL. Они упрощают репликацию binlog и облегчают диагностику проблем. Мы **рекомендуем** включить режим GTID, чтобы MySQL ClickPipe мог использовать репликацию на основе GTID. Репликация на основе GTID поддерживается для Amazon Aurora MySQL v2 (MySQL 5.7) и v3 (MySQL 8.0), а также Aurora Serverless v2. Чтобы включить режим GTID для экземпляра Aurora MySQL, выполните следующие шаги: 1. В RDS Console выберите свой экземпляр MySQL. 2. Перейдите на вкладку **Configuration**. 3. Нажмите ссылку группы параметров. 4. Нажмите кнопку **Edit** в правом верхнем углу. 5. Установите `enforce_gtid_consistency` в значение `ON`. 6. Установите `gtid-mode` в значение `ON`. 7. Нажмите **Save Changes** в правом верхнем углу. 8. Перезагрузите экземпляр, чтобы изменения вступили в силу. Режим GTID включен
## Настройте пользователя базы данных
Подключитесь к своему экземпляру Aurora MySQL с правами администратора и выполните следующие команды: 1. Создайте отдельного пользователя для ClickPipes: ```sql theme={null} CREATE USER 'clickpipes_user'@'%' IDENTIFIED BY 'some-password'; ``` 2. Выдайте права на схему. В следующем примере показаны права для базы данных `mysql`. Повторите эти команды для каждой базы данных и каждого хоста, для которых вы хотите настроить репликацию: ```sql theme={null} GRANT SELECT ON `mysql`.* TO 'clickpipes_user'@'host'; ``` 3. Выдайте пользователю права на репликацию: ```sql theme={null} GRANT REPLICATION CLIENT ON *.* TO 'clickpipes_user'@'%'; GRANT REPLICATION SLAVE ON *.* TO 'clickpipes_user'@'%'; ```
### Использование аутентификации IAM (необязательно)
Вместо пароля можно аутентифицировать пользователя ClickPipes с помощью ролевого доступа AWS IAM. Создайте пользователя, как показано ниже, а затем выдайте ему то же право на схему и привилегии на репликацию, что и выше: ```sql theme={null} CREATE USER 'clickpipes_iam_user' IDENTIFIED WITH AWSAuthenticationPlugin AS 'RDS'; ``` См. [AWS IAM DB authentication (RDS/Aurora)](/ru/integrations/clickpipes/postgres/auth), где приведены полные инструкции по настройке роли IAM и политики, необходимых для аутентификации ClickPipes таким способом.
## Настройте сетевой доступ
### Управление доступом по IP
Чтобы ограничить трафик к вашему экземпляру Aurora MySQL, добавьте [задокументированные статические NAT IP-адреса](/ru/integrations/clickpipes/home#list-of-static-ips) в **Inbound rules** вашей группы безопасности Aurora. Где найти группу безопасности в Aurora MySQL? Изменение Inbound rules для указанной выше группы безопасности Чтобы подключиться к вашему экземпляру Aurora MySQL по закрытой сети, можно использовать AWS PrivateLink. Для настройки подключения следуйте [руководству по настройке AWS PrivateLink для ClickPipes](/ru/resources/support-center/knowledge-base/cloud-services/aws-privatelink-setup-for-clickpipes).
## Что дальше?
Теперь, когда ваш экземпляр Amazon Aurora MySQL настроен для репликации через binlog и безопасно подключён к ClickHouse Cloud, вы можете [создать свой первый MySQL ClickPipe](/ru/integrations/clickpipes/mysql/index#create-your-clickpipe). Ответы на распространённые вопросы по MySQL CDC см. на [странице с часто задаваемыми вопросами по MySQL](/ru/integrations/clickpipes/mysql/faq).