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

> Configure qualquer instância do MariaDB como fonte para o ClickPipes

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

<Info>
  Se você usa um dos provedores compatíveis (na barra lateral), consulte o guia específico desse provedor.
</Info>

<div id="enable-binlog-retention">
  ## Habilitar a retenção do log binário
</div>

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:

```sql theme={null}
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:

```sql theme={null}
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`):

```ini theme={null}
[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.

<Note>
  A exclusão de colunas não é compatível com o MariaDB \<= 10.4 porque a configuração `binlog_row_metadata` ainda não havia sido introduzida.
</Note>

<div id="configure-database-user">
  ## Configure um usuário do banco de dados
</div>

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:

   ```sql theme={null}
   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:

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

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

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

<Note>
  Substitua `clickpipes_user` e `some_secure_password` pelo nome de usuário e pela senha que desejar.
</Note>

<div id="ssl-tls-configuration">
  ## Configuração de SSL/TLS (recomendada)
</div>

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](/docs/pt-BR/integrations/clickpipes/mysql/faq#tls-certificate-validation-error).

<div id="whats-next">
  ## O que vem a seguir?
</div>

Agora você pode [criar seu ClickPipe](/docs/pt-BR/integrations/clickpipes/mysql/index) 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.