[FAQ] cdc 升级报错 Error: component cdc’s config file /apps/tidb/cdc/cdc-config.toml contained unknown configuration options

[问题澄清]

cdc 从 4.0 rc 版本升级到 4.0 GA 版本遇到报错:

Error: component cdc’s config file /apps/tidb/cdc/cdc-config.toml contained unknown configuration options: ignore-txn-commit-ts, filter-case-sensitive, filter-rules, filter-rules.ignore-dbs, filter-rules.do-tables, filter-rules.do-tables.db-name, filter-rules.do-tables.tbl-name, filter-rules.do-tables, filter-rules.do-tables.db-name, filter-rules.do-tables.tbl-name, filter-rules.do-tables, filter-rules.do-tables.db-name, filter-rules.do-tables.tbl-name, filter-rules.do-tables, filter-rules.do-tables.db-name, filter-rules.do-tables.tbl-name Usage: cdc cli changefeed create [flags]

[原因分析]

在 4.0.0 版本做了一些不兼容的变更:

1、优化了 Changefeed 配置文件格式

2、优化了 PD 维护的 TiCDC 元数据结构

[解决方案]

升级方案:

1、停止 cdc server 进程:

tiup cluster stop -R cdc

2、升级集群:

tiup cluster upgrade 4.0.0

3、清空 PD 中存储的 TiCDC 元数据:

cdc cli meta delete —pd=xxxxx

4、使用 4.0.0 版本的 cdc binary 重建 changefeed:

cdc cli changefeed create xxxx

[参考案例]