Guia de configuração da fonte MariaDB genérica

Os logs binários contêm informações sobre modificações de dados feitas em uma instância do servidor MariaDB e são necessários para a replicação.

Para habilitar o log binário na sua instância do MariaDB, verifique se as seguintes configurações estão definidas:

server_id = 1               -- ou maior; qualquer valor exceto 0
log_bin = ON
binlog_format = ROW
binlog_row_image = FULL
binlog_row_metadata = FULL  -- introduzido na versão 10.5.0
expire_logs_days = 1        -- ou maior; 0 significa que os logs serão preservados indefinidamente

Para verificar essas configurações, execute os seguintes comandos 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';

Se os values não coincidirem, você pode defini-los no arquivo de config (geralmente em /etc/my.cnf ou /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  ; somente na versão 10.5.0 e posteriores
expire_logs_days = 1

Se o banco de dados de origem for uma réplica, certifique-se de também ativar log_slave_updates.

Você PRECISA REINICIAR a instância do MariaDB para que as alterações entrem em vigor.

Conecte-se à sua instância do MariaDB como usuário root e execute os seguintes comandos:

1. Crie um usuário dedicado para o ClickPipes:

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

2. Conceda permissões no esquema. O exemplo abaixo mostra as permissões para o banco de dados clickpipes. Repita esses comandos para cada banco de dados e host que você queira replicar:

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

3. Conceda permissões de replicação ao usuário:

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

Os certificados SSL garantem conexões seguras com seu banco de dados MariaDB. A configuração depende do tipo de certificado:

Autoridade certificadora confiável (DigiCert, Let's Encrypt etc.) - nenhuma configuração adicional é necessária.

Autoridade certificadora interna - Obtenha o arquivo do certificado da CA raiz com a sua equipe de TI. Na UI do ClickPipes, faça upload dele ao criar um novo MariaDB ClickPipe.

MariaDB self-hosted - Copie o certificado da CA do seu servidor MariaDB (consulte o caminho pela configuração ssl_ca no seu my.cnf). Na UI do ClickPipes, faça upload dele ao criar um novo MariaDB ClickPipe. Use o endereço IP do servidor como host.

MariaDB self-hosted a partir da versão 11.4 - Se o seu servidor tiver ssl_ca configurado, siga a opção acima. Caso contrário, consulte a sua equipe de TI para provisionar um certificado adequado. Como último recurso, use a opção "Ignorar verificação de certificado" na UI do ClickPipes (não recomendado por motivos de segurança).

Para mais informações sobre as opções de SSL/TLS, consulte nosso FAQ.

Agora você pode criar seu ClickPipe e começar a fazer a ingestão de dados da sua instância do MariaDB para o ClickHouse Cloud. Certifique-se de anotar os detalhes da conexão usados ao configurar sua instância do MariaDB, pois você precisará deles durante o processo de criação do ClickPipe.