Руководство по настройке источника для универсальной MariaDB

Настройте любой экземпляр MariaDB как источник для ClickPipes

Если вы используете одного из поддерживаемых провайдеров (см. боковую панель), обратитесь к соответствующему руководству для этого провайдера.

​

Включите хранение бинарных логов

Бинарные логи содержат сведения об изменениях данных на экземпляре сервера MariaDB и необходимы для репликации.

Чтобы включить бинарное логирование на вашем экземпляре MariaDB, убедитесь, что заданы следующие параметры:

server_id = 1               -- или больше; любое значение, кроме 0
log_bin = ON
binlog_format = ROW
binlog_row_image = FULL
binlog_row_metadata = FULL  -- добавлено в 10.5.0
expire_logs_days = 1        -- или больше; значение 0 означает бессрочное хранение журналов

Чтобы проверить эти настройки, выполните следующие SQL-команды:

SHOW VARIABLES LIKE 'server_id';
SHOW VARIABLES LIKE 'log_bin';
SHOW VARIABLES LIKE 'binlog_format';
SHOW VARIABLES LIKE 'binlog_row_image';
SHOW VARIABLES LIKE 'binlog_row_metadata';
SHOW VARIABLES LIKE 'expire_logs_days';

Если значения не совпадают, их можно указать в конфигурационном файле (обычно в /etc/my.cnf или /etc/my.cnf.d/mariadb-server.cnf):

[mysqld]
server_id = 1
log_bin = ON
binlog_format = ROW
binlog_row_image = FULL
binlog_row_metadata = FULL  ; только начиная с версии 10.5.0
expire_logs_days = 1

Если исходная база данных — реплика, убедитесь, что log_slave_updates тоже включён.

Необходимо ПЕРЕЗАПУСТИТЬ экземпляр MariaDB, чтобы изменения вступили в силу.

Исключение столбцов не поддерживается в MariaDB <= 10.4, поскольку параметр binlog_row_metadata в этой версии ещё не был доступен.

​

Настройка пользователя базы данных

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

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

   CREATE USER 'clickpipes_user'@'%' IDENTIFIED BY 'some_secure_password';
   

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

   GRANT SELECT ON `clickpipes`.* TO 'clickpipes_user'@'%';
   

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

   GRANT REPLICATION CLIENT ON *.* TO 'clickpipes_user'@'%';
   GRANT REPLICATION SLAVE ON *.* TO 'clickpipes_user'@'%';
   

Обязательно замените clickpipes_user и some_secure_password на нужные имя пользователя и пароль.

​

Настройка SSL/TLS (рекомендуется)

SSL‑сертификаты обеспечивают защищённое подключение к вашей базе данных MariaDB. Настройка зависит от типа сертификата:

Доверенный центр сертификации (DigiCert, Let’s Encrypt и т. д.) - дополнительная настройка не требуется.

Внутренний центр сертификации - Получите файл корневого CA‑сертификата у вашей ИТ‑команды. В интерфейсе ClickPipes загрузите его при создании нового MariaDB ClickPipe.

Самоуправляемая MariaDB - Скопируйте CA‑сертификат с сервера MariaDB (путь можно посмотреть в параметре ssl_ca в файле my.cnf). В интерфейсе ClickPipes загрузите его при создании нового MariaDB ClickPipe. В качестве хоста используйте IP‑адрес сервера.

Самоуправляемая MariaDB, начиная с 11.4 - Если на вашем сервере настроен ssl_ca, следуйте варианту выше. В противном случае обратитесь к вашей ИТ‑команде, чтобы получить корректный сертификат. В крайнем случае используйте переключатель “Skip Certificate Verification” в интерфейсе ClickPipes (не рекомендуется по соображениям безопасности).

Дополнительную информацию о параметрах SSL/TLS см. в нашем FAQ.

​

Что дальше?

Теперь вы можете создать свой ClickPipe и начать импорт данных из вашего экземпляра MariaDB в ClickHouse Cloud. Обязательно сохраните сведения о подключении, которые вы использовали при настройке экземпляра MariaDB, — они понадобятся вам при создании ClickPipe.