跳到主要内容

TiDB

选择对端数据库:

数据链路

基本功能

功能说明
结构迁移

如目标不存在所选表,则自动根据源端元数据,结合映射生成对端创建语句并执行创建

全量数据迁移

逻辑迁移,通过顺序扫描表数据,将数据分批写入到对端数据库

增量实时同步

支持 INSERT, UPDATE, DELETE 常见 DML 同步
无主键表 UPDATE、DELETE 不同步(需手动勾选)

数据校验和订正

全量数据校验,并可选根据校验结果订正差异数据,支持定时,文档:创建定时校验订正任务

修改订阅

新增、删除、修改订阅表,支持历史数据迁移,文档:修改订阅

重置位点

时间戳 回溯位点,重新消费过去一段时间未被 TiKV GC 掉的增量数据

表名映射

支持 和源端保持一致, 转小写, 转大写, 以'_数字'后缀截取

DDL 同步
  • ALTER TABLE ADD , MODIFY , DROP COLUMN
  • TRUNCATE TABLE
  • ALTER TABLE RENAME TO
  • CREATE TABLE
元数据检索

从源端表查对端,查询设置过过滤条件的

高级功能

功能说明
全量前清空目标数据

运行全量任务前清除老数据,包括重跑任务、定时全量迁移都会触发此能力

重建目标表

运行全量任务前重建目标表,包括重跑任务、定时全量迁移都会触发此能力

增量写入冲突策略

IGNORE: 主键冲突则忽略(不做写入),REPLACE: 主键冲突则整行替换

0 值时间处理

支持将 0 值时间设置成不同类型的值,防止写入对端报错

定时全量迁移

文档1:创建定时全量任务
文档2:定时全量实现增量数据迁移

自定义代码

文档1:创建自定义代码任务
文档2:自定义代码任务 debug
文档3:在自定义代码中打日志

数据过滤条件

支持 WHERE 条件进行数据过滤,内容为 SQL 92 子集,文档:创建数据过滤任务

限制和注意点

限制项说明
TiDB 数据类型

不支持地理位置类型


源端数据源

前置条件

条件说明
账号权限

文档: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

cdcEventBufferSize

任务接收增量数据的缓冲池大小, 在任务规格范围内设置的越大越好

cdcBatchMaxSize

任务每次处理缓冲池中增量数据的最大数量,建议为 cdcEventBufferSize * 0.05 大小

cdcGrpcTimeout

任务与 PD 节点 gRpc 连接通道的超时时间,单位ms

cdcStubTimeout

gRpc 通道中的每个 stub 的超时时间,超过该时间会自动重新订阅,单位ms

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


目标端数据源

前置条件

条件说明
账号权限

迁移库表的 INSERT, UPDATE, DELETE, DDL 权限

网络准备

迁移同步节点(sidecar)可连接 TiDB 标准交互接口(如 4000)

任务参数

参数名称说明
keyConflictStrategy

增量写入遇到主键冲突策略:

  • IGNORE 冲突忽略(默认)
  • REPLACE 冲突替换(可选)

dstWholeReplace

将 INSERT 和 UPDATE 操作变成对端整行覆盖

writeStrategy

对端写入策略,包含

  • ROW (单条,默认选项)
  • MULTI_SQL (多语句)

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

数据链路

基本功能

高级功能

限制和注意点

使用示例

链路FAQ

源端数据源

前置条件

任务参数

目标端数据源

前置条件

任务参数