首页/数据/数据工程与 ETL 速查/Debezium snapshot.mode 快照模式
CDC 与同步53 条

Debezium snapshot.mode 快照模式

snapshot.mode 控制连接器启动时的快照行为:initial 先全量快照再转增量(默认);schema_only(旧名 no_data)只记录结构不导数据;initial_only 只做快照不继续增量;schema_only_recovery 用于修复 schema 历史主题后的重启。模式选错会漏数或重复初始化。

常用模式

模式行为典型场景
initial全量快照 + 继续增量首次接入新链路
schema_only只快照结构,从当前位点继续已有全量基线,只需要增量
initial_only只做快照,不进入增量一次性导出
schema_only_recovery只快照结构并重置历史记录schema 历史主题损坏后恢复
schema_only 跳过数据快照:目标端没有全量基线时用它,历史数据永远不会进管道。

易错点

  • 误用 schema_only 接入新链路,上线后发现只有变更没有历史数据
  • 快照期间写入量大,未评估锁策略与源库读压力就上线

数据来源与参考

  • Debezium 官方文档(snapshot.mode 属性说明)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌