SAP HANA 到 Kafka

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

选择对端数据库：

Kafka

数据链路

基本功能

功能	说明
结构迁移	如目标端不存在指定映射规则后的 Topic, 则自动进行 Topic 创建，并支持设置分区数
全量数据迁移	逻辑迁移，通过顺序扫描表数据，将数据分批写入到消息中间件
增量实时同步	支持 INSERT、UPDATE、DELETE 常见 DML 同步
修改订阅	新增、删除、修改订阅表，支持历史数据迁移，文档：修改订阅
增量位点回溯	支持按照数据 ID、时间戳 回溯位点，重新消费过去一段时间的 CDC 数据
表名映射	支持 和源端保持一致, 转小写, 转大写
元数据检索	从源端表查对端，查询设置过过滤条件的，查询设置过对端主键的

高级功能

功能	说明
基于 Trigger 增量同步	任务会自动创建表的触发器，触发器能捕获数据的 INSERT / UPDATE / DELETE 事件并写入增量 CDC 数据表
消息格式	支持以下消息格式，文档：消息格式说明 CloudCanal内置格式 AlibabaCanal兼容格式
表级别 Topic	最小按照源端表级别设置对应的 Topic, 支持自动获取表分区
DDL 专用 Topic	支持指定 Topic 发送 DDL, 如未指定，则放置 DDL 时间在对应表 Topic 分区 0 中
定时全量迁移	文档1：创建定时全量任务 文档2：定时全量实现增量数据迁移
自定义代码	文档1：创建自定义代码任务 文档2：自定义代码任务 debug 文档3：在自定义代码中打日志
数据过滤条件	支持 WHERE 条件进行数据过滤，内容为 SQL 92 子集，文档：创建数据过滤任务

限制和注意点

限制项	说明
DDL 变化处理方案	SAP HANA 源端通过触发器捕获增量数据，不支持 DDL 同步。若发生 DDL 变更，可参考文档：SAP HANA 源端表结构变更
HANA 增量同步数据类型	HANA 增量阶段，触发器不支持捕获 TEXT、BIN_TEXT、ST_POINT、ST_GEOMETRY 类型的数据变更
Hana 触发器记录变更前的数据	考虑到 Hana 触发器的执行效率，单 CDC 表模式下，目前只记录变更前的主键数据

使用示例

标题	详情
跨互联网数据互通 (Kafka)	文档：跨互联网数据互通 (Kafka)
Kafka 数据中转校验	文档：Kafka 数据中转校验

链路FAQ

• SAP HANA 测试链接报错

---

源端数据源

前置条件

条件	说明
账号权限	文档：HANA 需要的权限

任务参数

参数名称	说明
sysTriggerDataSchema	触发器写入增量表 SCHEMA 名称
sysTriggerDataTable	触发器写入增量表 TABLE 名称
incrPagingCount	触发器增量同步每次查询数据总量
incrIdleSleepSecond	触发器的增量同步空闲时查询间隔（单位：秒）
incrScanIntervalMs	设置基于触发器的增量同步数据查询间隔（单位：毫秒）
autoCheckTriggerAndReInstall	任务启动时检查触发器状态并重新安装
triggerDataCleanEnabled	是否开启定时清理触发器增量表数据
triggerDataCleanIntervalMin	设置触发器增量表的清理间隔（单位：分钟）
triggerDataRetentionMin	设置触发器增量表数据的保留时间（单位：分钟）
dbHeartbeatEnable	配置对源端数据库是否开启心跳
needTriggerDataJsonEscape	是否对触发器增量表数据加转义符（\）
triggerDataJsonQuotation	自定义触发器增量表 JSON 数据引号
triggerParamBathSize	设置触发器模板中每个变量包含列的个数
fullBeforeImageEnabled	触发器是否记录所有列变更前的完整数据

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

---

目标端数据源

前置条件

条件	说明
网络准备	迁移同步节点（sidecar）可连接 Kafka 各节点

任务参数

参数名称	说明
schemaFormat	消息格式，文档：消息格式说明
batchWriteSize	单条消息最大数据条数，超过则拆分消息
defaultTopic	无法找到对应 Topic 的消息则发送到此 Topic (如新增表)
ddlTopic	专门发送 DDL 的 Topic, 为空则发送到对应 Topic 的第 0 个分区
compressionType	Kafka compression.type 参数, 设置压缩算法, 支持 GZIP, SNAPPY, LZ4, ZSTD 算法
batchSize	Kafka batch.size 参数
acks	Kafka acks 参数, 默认 all
maxRequestBytes	Kafka max.request.size 参数
lingerMs	Kafka linger.ms 参数, 默认 1
envelopSchemaInclude	当 schemaFormat 设置为 DEBEZIUM_ENVELOP_JSON_FOR_MQ 时，消息体是否包含 schema 信息
customClientProps	自定义传入到 Kafka Client 参数，JSON 格式，key为参数名，value为参数值。此配置项以最高优先级生效。例如：AWS IAM 访问控制

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