> ## 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.
> 将 Amazon RDS MariaDB 配置为 ClickPipes 数据源的分步指南
# RDS MariaDB 数据源设置指南
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
这是一份分步指南，说明如何配置您的 RDS MariaDB 实例，以便通过 MySQL ClickPipe 复制其中的数据。
我们还建议阅读[这里](/docs/zh/integrations/clickpipes/mysql/faq)的 MySQL 常见问题页面。该页面正在持续更新。
## 启用二进制日志保留
二进制日志是一组日志文件，其中包含对 MySQL 服务器实例所做的数据修改信息。复制需要二进制日志文件。必须同时执行以下两个步骤：
MySQL 是否启用二进制日志记录由自动备份功能决定。可以在 AWS Console 中进行设置：
建议根据复制用例将备份保留策略设置为足够长的时长。
Amazon RDS for MariaDB 设置 binlog 保留时长的方法有所不同。binlog 保留时长是指包含变更的二进制日志文件会保留多久。如果某些变更在 binlog 文件被删除前尚未被读取，复制将无法继续。binlog 保留时长 (小时) 的默认值为 NULL，表示不会保留二进制日志。
要指定某个 DB 实例上二进制日志的保留小时数，请使用 `mysql.rds_set_configuration` 函数，并将 binlog 保留周期设置得足够长，以确保复制能够进行。建议的最短时长为 `24 hours`。
```text theme={null}
mysql=> call mysql.rds_set_configuration('binlog retention hours', 24);
```
## 在参数组中配置 binlog 设置
在 RDS 控制台中点击你的 MariaDB 实例，然后进入 `Configurations` 选项卡，即可找到参数组。
点击参数组链接后，会进入其详情页面。你会在右上角看到一个 Edit 按钮：
需要按如下方式设置 `binlog_format`、`binlog_row_metadata` 和 `binlog_row_image`：
1. 将 `binlog_format` 设置为 `ROW`。
2. 将 `binlog_row_metadata` 设置为 `FULL`
3. 将 `binlog_row_image` 设置为 `FULL`
接下来，点击右上角的 `Save Changes`。这些更改可能需要重启实例后才会生效。如果你在 RDS 实例的 `Configurations` 选项卡中看到参数组链接旁显示 `Pending reboot`，通常就表示需要重启实例。
如果你使用的是 MariaDB cluster，则上述参数应位于 [DB Cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.CreatingCluster.html) parameter group 中，而不是 DB instance group 中。
## 启用 GTID 模式
全局事务标识符 (GTID) 是分配给 MySQL/MariaDB 中每个已提交事务的唯一 ID。它可以简化 binlog 复制，并让故障排查更直接。MariaDB 默认启用 GTID 模式，因此无需用户执行任何操作即可使用。
## 配置数据库用户
以管理员用户身份连接到您的 RDS MariaDB 实例，并执行以下命令：
1. 为 ClickPipes 创建一个专用用户：
```sql theme={null}
CREATE USER 'clickpipes_user'@'host' IDENTIFIED BY 'some-password';
```
2. 授予 schema 权限。以下示例展示了 `mysql` database 的权限。对于您要复制的每个 database 和主机，请重复执行这些命令：
```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'@'%';
```
## 配置网络访问
### 基于 IP 的访问控制
如果你想限制访问 RDS 实例的流量，请将[文档中列出的静态 NAT IP 地址](/docs/zh/integrations/clickpipes/home#list-of-static-ips)添加到 RDS 安全组 (Security Group) 的 `Inbound rules` 中。
### 通过 AWS PrivateLink 进行私网访问
要通过私网连接到您的 RDS 实例，您可以使用 AWS PrivateLink。请按照我们的 [ClickPipes 的 AWS PrivateLink 设置指南](/docs/zh/resources/support-center/knowledge-base/cloud-services/aws-privatelink-setup-for-clickpipes) 配置连接。