PostgreSQL 到 ClickHouse

CloudCanal 支持从 PostgreSQL 到 ClickHouse 的数据迁移、同步、校验和链路能力。

选择对端数据库：

ClickHouse

数据链路

功能	说明
结构迁移	如目标不存在所选表，则自动根据源端元数据，结合映射生成对端创建语句并执行创建
全量数据迁移	逻辑迁移，通过顺序扫描表数据，将数据分批写入到对端数据库
增量实时同步	支持 INSERT, UPDATE, DELETE 常见 DML 同步
数据校验	全量数据校验, 并支持定时
修改订阅	新增、删除、修改订阅表，支持历史数据迁移，文档：修改订阅
重置位点	支持按照文件位点、时间戳回溯位点，重新消费过去一段时间或指定 Binlog 文件和位点开始的增量日志
表名映射	支持和源端保持一致, 转小写, 转大写, 以'_数字'后缀截取
DDL 同步	PostgreSQL DDL 同步基于触发器实现，需具备相应的触发器和表权限。文档：PostgreSQL 需要的权限 ALTER TABLE ADD COLUMN, DROP COLUMN, MODIFY COLUMN, CHANGE COLUMN CREATE TABLE（全库同步）
元数据检索	从源端表查对端，查询设置过过滤条件的，查询设置过对端主键的

功能	说明
追加模式写入	INSERT 和 UPDATE 以追加模式批量写入, DELETE 单独通过 ALTER 方式执行
定时优化表	通过设置 autoOptimizeThresholdSec 参数，定时优化表
定时全量迁移	文档1：创建定时全量任务文档2：定时全量实现增量数据迁移
自定义代码	文档1：创建自定义代码任务文档2：自定义代码任务 debug 文档3：在自定义代码中打日志
数据过滤条件	支持 WHERE 条件进行数据过滤，内容为 SQL 92 子集，文档：创建数据过滤任务
设置目标主键	变更主键为其他字段，方便数据聚合等操作
添加虚拟列	支持添加自定义的虚拟列，指定的值为固定值，如区域、编号等

限制项	说明
特殊操作	DELETE 操作过多（>50 条/秒）将大幅影响数据同步性能
目标端表引擎	仅支持以下表引擎以及对应的源端表类型: MergeTree（无主键表） ReplacingMergeTree（有主键表） ReplicatedMergeTree（无主键表） ReplicatedReplacingMergeTree（有主键表）

限制项

说明

特殊操作

DELETE 操作过多（>50 条/秒）将大幅影响数据同步性能

目标端表引擎

仅支持以下表引擎以及对应的源端表类型:

条件	说明
账号权限	需要权限如下(以自建数据库为例): GRANT ALL PRIVILEGES ON DATABASE 同步库 TO 同步账号（或同步库 information_schema 中所有视图的 SELECT 权限和需要同步表、索引、约束的 SELECT 权限) ALTER USER 同步账号 REPLICATION
增量同步准备	准备动作按如下步骤进行: 修改 postgresql.conf, 设置 wal_level=logical 和 wal_log_hints = on 修改 pg_hba.conf, 设置 host replication 同步账号 CIDR网段 md5 , host 同步库同步账号 CIDR网段 md5, host postgres 同步账号 CIDR网段 md5 重启 PostgreSQL
网络准备	迁移同步节点（sidecar）可连接 PostgreSQL 标准交互接口（如 5432）

条件

说明

账号权限

需要权限如下(以自建数据库为例):

GRANT ALL PRIVILEGES ON DATABASE 同步库 TO 同步账号（或同步库 information_schema 中所有视图的 SELECT 权限和需要同步表、索引、约束的 SELECT 权限)
ALTER USER 同步账号 REPLICATION

增量同步准备

准备动作按如下步骤进行:

修改 postgresql.conf, 设置 wal_level=logical 和 wal_log_hints = on
修改 pg_hba.conf, 设置 host replication 同步账号 CIDR网段 md5 , host 同步库同步账号 CIDR网段 md5, host postgres 同步账号 CIDR网段 md5
重启 PostgreSQL

网络准备

迁移同步节点（sidecar）可连接 PostgreSQL 标准交互接口（如 5432）

Tips: 通用参数配置请参考通用参数及功能

条件	说明
账号权限	具备 SELECT, INSERT, 常见 DDL 权限
网络准备	迁移同步节点（sidecar）可连接 ClickHouse 标准交互接口（如 8123）

参数名称	说明
multiReplica	是否为多副本集群
clusterName	集群名称，当 multiReplica 为 true, 则自动在 DDL/DML 中加入 ON CLUSTER clusterName 子句
ckTableEngine	当前支持以下表引擎: MergeTree ReplacingMergeTree ReplicatedMergeTree ReplicatedReplacingMergeTree
autoOptimizeThresholdSec	定时优化表（optimize table final）间隔，<=0 则关闭此功能
enableTimeRangeClamping	是否启用时间范围裁剪,强制将时间和日期值收束到 ClickHouse JDBC 的合法区间内，超出的数值将被截断至最小值或最大值。默认关闭（false）。收束后范围(UTC)： Date：[1970-01-01, 2149-06-06] Date32：[1925-01-01, 2283-11-11] Timestamp：[1970-01-01 00:00:00, 2106-02-07 14:28:15] Timestamp64：[1925-01-01 08:00:00.000, 2283-11-12 07:59:59.000]

Tips: 通用参数配置请参考通用参数及功能