TiDB 到 Doris

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

选择对端数据库：

Doris

数据链路

基本功能

功能	说明
结构迁移	如目标不存在所选表，则自动根据源端元数据，结合映射生成对端创建语句并执行创建
全量数据迁移	逻辑迁移，通过顺序扫描表数据，将数据分批写入到对端数据库
增量实时同步	支持 INSERT, UPDATE, DELETE 常见 DML 同步
数据校验和订正	全量数据校验，并可选根据校验结果订正差异数据，支持定时，文档：创建定时校验订正任务
修改订阅	新增、删除、修改订阅表，支持历史数据迁移，文档：修改订阅
重置位点	按 时间戳 回溯位点，重新消费过去一段时间未被 TiKV GC 掉的增量数据
表名映射	支持 和源端保持一致, 转小写, 转大写, 以'_数字'后缀截取
DDL 同步	ALTER TABLE ADD COLUMN, MODIFY COLUMN, RENAME COLUMN, DROP COLUMN RENAME TABLE CREATE TABLE
元数据检索	从源端表查对端，查询设置过过滤条件的，查询设置过对端主键的

高级功能

功能	说明
全量前清空目标数据	运行全量任务前清除老数据，包括重跑任务、定时全量迁移都会触发此能力
重建目标表	运行全量任务前重建目标表，包括重跑任务、定时全量迁移都会触发此能力
Stream Load 数据写入	采用 Stream Load 到 Doris / SelectDB be 写入数据, 默认攒批写入，可动态调节刷出数据节奏和批次大小
0 值时间处理	支持将 0 值时间设置成不同类型的值，防止写入对端报错
支持分区表定义	创建任务时，可按表粒度指定分区定义（静态或动态）,结构迁移时自动添加该分区定义
定时全量迁移	文档1：创建定时全量任务 文档2：定时全量实现增量数据迁移
自定义代码	文档1：创建自定义代码任务 文档2：自定义代码任务 debug 文档3：在自定义代码中打日志
数据过滤条件	支持 WHERE 条件进行数据过滤，内容为 SQL 92 子集，文档：创建数据过滤任务

限制和注意点

限制项	说明
对端表类型	仅支持 唯一键模型(Unique)
源端表类型	不支持 无主键表 迁移同步
数据类型	不支持 BINARY, BLOB 等二进制类型
增量写入冲突策略	Stream Load 写入以主键进行整行替换

链路FAQ

• Doris / SelectDB 目标端写入报错

---

源端数据源

前置条件

条件	说明
账号权限	文档：TiDB 需要的权限
PD节点网络连通	请确保 CloudCanal 各节点能正常与 PD 各节点通讯 telnet [PD节点IP] [PD节点端口号]
TiKV GC 回收频率	在 TiDB Server 中修改 GC 周期时间为 24小时 以上 set global tidb_gc_life_time = "24h0m0s";
TiKV 历史变更数据缓存	建议根据任务所需适当调整大小 old-value-cache-memory-quota：增量旧数据占用 TiKV 节点的内存的上限 sink-memory-quota：增量数据占用 TiKV 节点的内存的上限

任务参数

参数名称	说明
printDetailLog	打印接收到的增量，常用于判断源端是否有增量数据推送
pdHost	任务请求的 PD 节点地址，格式为: [PD_IP]:[PD_PORT], 多个 PD 节点用 , 隔开 例: 127.0.0.1:2379,127.0.0.1:2380
cdcGrpcTimeout	任务与 PD 节点 gRpc 连接通道的超时时间，单位ms
cdcStubTimeout	gRpc 通道中的每个 stub 的超时时间，超过该时间会自动重新订阅，单位ms
fastFailKeywords	字符串数组，以逗号分隔，当异常信息中包含这些关键字时，任务不再尝试重连，直接重启。例如 DEADLINE_EXCEEDED 表示当 gRPC 超时异常时不再重连，直接重启任务

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

---

目标端数据源

前置条件

条件	说明
账号权限	具备 SELECT, DDL 权限(可选)
网络准备	迁移同步节点（sidecar）可连接 Doris / SelectDB FE QueryPort 和 FE/BE HttpPort

任务参数

参数名称	说明
host	MySQL 协议交互链接，对应 Doris / SelectDB FE QueryPort
httpHost	Doris stream load 链接，对应 Doris / SelectDB FE/BE HttpPort
totalDataInMemMb	攒批写入，内存中最大数据容量，超过此容量或超过 asyncFlushIntervalSec 则刷出数据到写入队列
asyncFlushIntervalSec	攒批写入，等待刷出的间隔时间，超过此时间或超过 totalDataInMemMb 则刷出数据到写入队列
flushBatchMb	单表最大攒批容量，超过此容量则刷出数据到写入队列
realFlushPauseSec	使用 stream load 刷出数据到 Doris / SelectDB 的等待时间，0 则不等待
soTimeoutSec	在 QueryPort 或 HttpPort 执行操作时 tcp 超时链接(so_timeout)
enableTimeZoneProcess	是否对时间字段进行时区转换
timezone	目标端 Doris/SelectDB 时区，例如 +08:00 Asia/Shanghai America/New_York
maxInSizePerQuery	校验任务中，对端单次查询的最大 IN 条件值数量，大于该值会自动拆分多次查询

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