Pular para o conteúdo principal
Este é um guia passo a passo sobre como configurar sua instância RDS MariaDB para replicar os dados por meio do ClickPipe do MySQL.
Também recomendamos consultar as FAQs do MySQL aqui. A página de FAQs é atualizada com frequência.

​
Habilitar a retenção do log binário

O log binário é um conjunto de arquivos de log que contêm informações sobre alterações de dados feitas em uma instância de servidor MySQL. Os arquivos de log binário são necessários para a replicação. As duas etapas abaixo devem ser seguidas:

​
1. Ative o log binário por meio de backup automatizado

O recurso de backups automatizados determina se o log binário está ativado ou desativado no MySQL. Ele pode ser configurado no Console da AWS: É recomendável definir a retenção de backups com um valor suficientemente longo, de acordo com o caso de uso de replicação.

​
2. Horas de retenção do binlog

O Amazon RDS for MariaDB tem um método diferente para definir a duração da retenção do binlog, ou seja, por quanto tempo um arquivo de binlog que contém alterações é mantido. Se algumas alterações não forem lidas antes de o arquivo de binlog ser removido, a replicação não poderá continuar. O valor padrão das horas de retenção do binlog é NULL, o que significa que os logs binários não são retidos. Para especificar o número de horas durante as quais os logs binários devem ser retidos em uma instância de banco de dados, use a função mysql.rds_set_configuration com um período de retenção de binlog longo o suficiente para que a replicação ocorra. 24 hours é o mínimo recomendado.

​
Configure as configurações do binlog no grupo de parâmetros

Você pode encontrar o grupo de parâmetros clicando na sua instância MariaDB no Console do RDS e, em seguida, navegando até a guia Configurations. Ao clicar no link do grupo de parâmetros, você será levado à página dele. Nela, você verá um botão Edit no canto superior direito: As configurações binlog_format, binlog_row_metadata e binlog_row_image precisam ser definidas da seguinte forma:
  1. binlog_format como ROW.
  1. binlog_row_metadata como FULL
  1. binlog_row_image como FULL
Em seguida, clique em Save Changes no canto superior direito. Talvez seja necessário reiniciar sua instância para que as alterações entrem em vigor. Se você vir Pending reboot ao lado do link do grupo de parâmetros na guia Configurations da instância do RDS, isso é um bom indicativo de que sua instância precisa ser reiniciada.
Se você tiver um cluster MariaDB, os parâmetros acima estarão em um grupo de parâmetros de DB Cluster, e não no grupo da instância de banco de dados.

​
Habilitando o modo GTID

Identificadores Globais de Transação (GTIDs) são IDs exclusivos atribuídos a cada transação confirmada no MySQL/MariaDB. Eles simplificam a replicação do binlog e tornam a solução de problemas mais simples. O MariaDB habilita o modo GTID por padrão, portanto nenhuma ação do usuário é necessária para utilizá-lo.

​
Configure um usuário do banco de dados

Conecte-se à sua instância do RDS MariaDB como um usuário administrador e execute os seguintes comandos:
  1. Crie um usuário dedicado para o ClickPipes:
  2. Conceda permissões de esquema. O exemplo a seguir mostra as permissões para o banco de dados mysql. Repita esses comandos para cada banco de dados e host que você deseja replicar:
  3. Conceda permissões de replicação ao usuário:

​
Configurar o acesso à rede

​
Controle de acesso por IP

Se você quiser restringir o tráfego para sua instância do RDS, adicione os IPs NAT estáticos documentados às Inbound rules do seu Security Group do RDS. Para se conectar à sua instância do RDS por uma rede privada, você pode usar o AWS PrivateLink. Siga nosso guia de configuração do AWS PrivateLink para ClickPipes para estabelecer a conexão.
Última modificação em 25 de junho de 2026