Skip to main content

支持的 Postgres 版本

ClickPipes 支持 Aurora PostgreSQL-Compatible Edition 12 及更高版本。

启用逻辑复制

如果你的 Aurora 实例已配置以下设置,则可以跳过本节:
  • rds.logical_replication = 1
如果你之前使用过其他数据复制工具,通常会预先启用此设置。
如果尚未配置,请按照以下步骤操作:
  1. 为您的 Aurora PostgreSQL 版本创建一个新的参数组,并配置所需设置:
    • rds.logical_replication 设置为 1
  1. 将新的参数组应用到您的 Aurora PostgreSQL 集群
  1. 重启您的 Aurora 集群以应用更改

配置数据库用户

以管理员身份连接到您的 Aurora PostgreSQL 写入 实例,并执行以下命令:
  1. 为 ClickPipes 创建一个专用用户:
  2. 为上一步创建的用户授予 schema 级别的只读访问权限。以下示例展示了 public schema 的权限。对每个包含待复制表的 schema,都重复执行这些命令:
  3. 向该用户授予复制特权:
  4. 使用您想要复制的表创建一个 publication。我们强烈建议仅在 publication 中包含必要的表,以避免额外的性能开销。
publication 中包含的任何表都必须定义了主键,_或_将其副本标识配置为 FULL。有关范围界定的指导,请参阅 Postgres FAQ
  • 为特定表创建 publication:
    • 为特定 schema 中的所有表创建 publication:
clickpipes publication 定义了哪些表的变更事件会流式传输到 ClickPipes。除非您打算复制所有表,否则不建议使用 FOR ALL TABLES,因为包含不必要的表会增加从 Postgres 到 ClickPipes 的 WAL 流量,并降低整体复制效率。

使用 IAM 身份验证 (可选)

您可以不使用密码,改为通过 AWS IAM 基于角色的访问控制来验证 ClickPipes 用户的身份。这要求将 rds.iam_auth_for_replication 参数设置为 1。按如下方式创建用户,然后授予其与上文所示相同的 schema 和复制特权:
有关设置 ClickPipes 通过这种方式进行身份验证所需的 IAM role 和策略的完整步骤,请参阅 AWS IAM DB 身份验证 (RDS/Aurora)

配置网络访问

基于 IP 的访问控制

如果你想限制流向 Aurora 集群的流量,请将文档中列出的静态 NAT IP 地址添加到 Aurora 安全组 (Security Group) 的 Inbound rules 中。 要通过私有网络连接到您的 Aurora 集群,您可以使用 AWS PrivateLink。请按照我们的 ClickPipes 的 AWS PrivateLink 设置指南 来建立连接。

Aurora 特定注意事项

在为 Aurora PostgreSQL 设置 ClickPipes 时,请牢记以下注意事项:
  1. 连接端点:始终连接到 Aurora 集群的写入端点,因为逻辑复制需要写入权限来创建 replication slots,并且必须连接到主实例。
  2. 故障转移处理:发生故障转移时,Aurora 会自动将一个只读实例提升为新的写入实例。ClickPipes 会检测到连接中断,并尝试重新连接到写入端点;此时该端点会指向新的主实例。
  3. Global Database:如果你使用的是 Aurora Global Database,应连接到主区域的写入端点,因为跨区域复制已经负责处理区域之间的数据移动。
  4. 存储注意事项:Aurora 的存储层由集群中的所有实例共享,与标准 RDS 相比,这通常能为逻辑复制提供更好的性能。

处理动态集群端点

虽然 Aurora 提供了可自动路由到相应实例的稳定端点,但还可以采用以下方法来进一步确保连接稳定:
  1. 对于高可用部署,请将应用程序配置为使用 Aurora 写入端点,它会自动指向当前的主实例。
  2. 如果使用跨区域复制,请考虑为每个区域分别设置 ClickPipes,以降低延迟并提高容错能力。

下一步是什么?

现在,您可以创建您的 ClickPipe,并开始将 Aurora PostgreSQL 集群中的数据摄取到 ClickHouse Cloud。 请务必记下您在设置 Aurora PostgreSQL 集群时使用的连接信息,因为在创建 ClickPipe 的过程中需要用到这些信息。
最后修改于 2026年7月23日