ticdc: clarify rolling upgrade guidance by wlwilliamx · Pull Request #21496 · pingcap/docs-cn

wlwilliamx · 2026-04-01T05:56:51Z

What is changed, added or deleted? (Required)

Clarify the rolling-upgrade guidance for old-architecture TiCDC.

Which TiDB version(s) do your changes apply to? (Required)

What is the related PR or file link(s)?

This PR is translated from:

Do your changes match any of the following descriptions?

Delete files
Change aliases
Need modification after applied to another branch
Might cause conflicts after applied to another branch

flowbehappy · 2026-04-01T07:57:33Z

ticdc/ticdc-compatibility.md


+## 历史版本升级的兼容性说明
+
+TiCDC 依赖 TiDB、TiKV 和 PD 提供的上游变更数据及相关接口。随着 TiDB 及相关产品持续演进，这些数据格式和接口可能发生变化。因此，TiCDC 不对与更高版本 TiDB/TiKV/PD 的跨版本混部提供正式的向上兼容性保证。


分别描述向下、向上兼容情况。并分别举个例子

向下兼容需要说支持 v6.5+ 吗

不兼容啊 Orz。老架构全都不支持跨版本兼容。只有新架构 8.5.4 开始才支持从 7.5 开始兼容

wlwilliamx · 2026-04-01T09:59:58Z

/retest

ti-chi-bot · 2026-04-01T11:25:24Z

@flowbehappy: adding LGTM is restricted to approvers and reviewers in OWNERS files.

Details

In response to this:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

ticdc/ticdc-compatibility.md

upgrade-tidb-using-tiup.md

ticdc/ticdc-architecture.md

ticdc/ticdc-compatibility.md

lidezhu · 2026-04-02T09:08:59Z

ticdc/ticdc-compatibility.md


+## 历史版本升级的兼容性说明
+
+TiCDC 依赖 TiDB、TiKV 和 PD 提供的上游变更数据及相关接口。随着 TiDB 及相关产品持续演进，这些数据格式和接口可能发生变化，例如 TiDB 的并行 DDL、快速建表等功能。这些功能的实现会修改相关的逻辑和数据处理流程，TiCDC 需要做相应的适配。因此，**老架构 TiCDC 不对与跨版本的 TiDB/TiKV/PD 混部提供正式的向上和向下兼容**性保证。在新架构中 TiCDC 中，我们会确保对 v7.5.0 及以上版本的 TiDB 集群的**向下兼容性**。


Suggested change

TiCDC 依赖 TiDB、TiKV 和 PD 提供的上游变更数据及相关接口。随着 TiDB 及相关产品持续演进，这些数据格式和接口可能发生变化，例如 TiDB 的并行 DDL、快速建表等功能。这些功能的实现会修改相关的逻辑和数据处理流程，TiCDC 需要做相应的适配。因此，**老架构 TiCDC 不对与跨版本的 TiDB/TiKV/PD 混部提供正式的向上和向下兼容**性保证。在新架构中 TiCDC 中，我们会确保对 v7.5.0 及以上版本的 TiDB 集群的**向下兼容性**。

TiCDC 依赖 TiDB、TiKV 和 PD 提供的上游变更数据及相关接口。随着 TiDB 及相关产品持续演进，这些数据格式和接口可能发生变化，例如 TiDB 的并行 DDL、快速建表等功能。这些功能的实现会修改相关的逻辑和数据处理流程，TiCDC 需要做相应的适配。因此，**老架构 TiCDC 不对与跨版本的 TiDB/TiKV/PD 混部提供正式的向上和向下兼容性保证**。在新架构中 TiCDC 中，我们会确保对 v7.5.0 及以上版本的 TiDB 集群的**向下兼容性**。

ticdc/ticdc-compatibility.md

lidezhu · 2026-04-02T09:10:04Z

upgrade-tidb-using-tiup.md


 - TiDB 目前暂不支持版本降级或升级后回退。
 - 支持 TiCDC，TiFlash 等组件版本的升级。
+- 如果集群中包含基于老架构实现的 TiCDC 历史版本（例如 `v6.5.0` 到 `v8.5.5`），不建议在 TiDB 滚动升级期间持续运行 changefeed。若目标 TiDB 版本高于老架构 TiCDC，必须先升级 TiCDC，升级到时，建议按“暂停所有 changefeed -> 升级 TiCDC -> 升级 TiDB 集群 -> 恢复 changefeed”的顺序执行。更多说明请参考 [TiCDC 历史版本滚动升级兼容性说明](/ticdc/ticdc-compatibility.md#历史版本升级的兼容性说明)。


Suggested change

- 如果集群中包含基于老架构实现的 TiCDC 历史版本（例如 `v6.5.0` 到 `v8.5.5`），不建议在 TiDB 滚动升级期间持续运行 changefeed。若目标 TiDB 版本高于老架构 TiCDC，必须先升级 TiCDC，升级到时，建议按“暂停所有 changefeed -> 升级 TiCDC -> 升级 TiDB 集群 -> 恢复 changefeed”的顺序执行。更多说明请参考 [TiCDC 历史版本滚动升级兼容性说明](/ticdc/ticdc-compatibility.md#历史版本升级的兼容性说明)。

- 如果集群中包含基于老架构实现的 TiCDC 历史版本（例如 `v6.5.0` 到 `v8.5.5`），不建议在 TiDB 滚动升级期间持续运行 Changefeed。若目标 TiDB 版本高于老架构 TiCDC，必须先升级 TiCDC，升级到时，建议按“暂停所有 Changefeed -> 升级 TiCDC -> 升级 TiDB 集群 -> 恢复 Changefeed”的顺序执行。更多说明请参考 [TiCDC 历史版本滚动升级兼容性说明](/ticdc/ticdc-compatibility.md#历史版本升级的兼容性说明)。

Co-authored-by: xixirangrang <hfxsd@hotmail.com> Co-authored-by: lidezhu <47731263+lidezhu@users.noreply.github.com>

ti-chi-bot · 2026-04-03T03:31:59Z

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please ask for approval from lilin90. For more information see the Code Review Process.
Please ensure that each of them provides their approval before proceeding.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

ticdc/ticdc-compatibility.md

upgrade-tidb-using-tiup.md

Co-authored-by: lidezhu <47731263+lidezhu@users.noreply.github.com>

ticdc/ticdc-compatibility.md

lilin90 · 2026-04-03T10:00:06Z

ticdc/ticdc-compatibility.md

+
+## 历史版本升级的兼容性说明
+
+TiCDC 依赖 TiDB、TiKV 和 PD 提供的上游变更数据及相关接口。随着 TiDB 及相关产品持续演进，这些数据格式和接口可能发生变化，例如 TiDB 的并行 DDL、快速建表等功能。这些功能的实现会修改相关的逻辑和数据处理流程，TiCDC 需要做相应的适配。因此，**老架构 TiCDC 不对与跨版本的 TiDB/TiKV/PD 混部提供正式的向上和向下兼容性保证**。在新架构中 TiCDC 中，支持对 v7.5.0 及以上版本的 TiDB 集群的**向下兼容性**。


Suggested change

TiCDC 依赖 TiDB、TiKV 和 PD 提供的上游变更数据及相关接口。随着 TiDB 及相关产品持续演进，这些数据格式和接口可能发生变化，例如 TiDB 的并行 DDL、快速建表等功能。这些功能的实现会修改相关的逻辑和数据处理流程，TiCDC 需要做相应的适配。因此，**老架构 TiCDC 不对与跨版本的 TiDB/TiKV/PD 混部提供正式的向上和向下兼容性保证**。在新架构中 TiCDC 中，支持对 v7.5.0 及以上版本的 TiDB 集群的**向下兼容性**。

TiCDC 依赖 TiDB、TiKV 和 PD 提供的上游变更数据及相关接口。随着 TiDB 及相关组件的持续演进，这些数据格式和接口可能发生变化，例如 TiDB 的并行 DDL、快速建表等功能会修改相关逻辑和数据处理流程，TiCDC 需要进行相应适配。因此，**老架构 TiCDC 不保证在跨版本的 TiDB/TiKV/PD 混合部署环境中提供正式的向上和向下兼容性**。新架构 TiCDC 支持对 v7.5.0 及以上版本的 TiDB 集群提供**向下兼容性**。

ticdc/ticdc-compatibility.md

lilin90 · 2026-04-03T10:10:16Z

upgrade-tidb-using-tiup.md

+
+- TiDB 目前暂不支持版本降级或升级后回退。
+- 支持 TiCDC，TiFlash 等组件版本的升级。
+- 如果集群中包含基于老架构实现的 TiCDC 历史版本（例如 `v6.5.0` 到 `v8.5.5`），不建议在 TiDB 滚动升级期间持续运行 Changefeed。若目标 TiDB 版本高于老架构 TiCDC，必须先升级 TiCDC。升级的时候，建议按“暂停所有 Changefeed -> 升级 TiCDC -> 升级 TiDB 集群 -> 恢复 Changefeed”的顺序执行。更多说明请参考 [TiCDC 历史版本滚动升级兼容性说明](/ticdc/ticdc-compatibility.md#历史版本升级的兼容性说明)。


这里是指从 v6.5.0 升级到 v8.5.5，还是 v6.5.0 到 v8.5.5 的版本都是老架构版本？读起来有点歧义。如果是第二个意思，https://docs.pingcap.com/zh/tidb/stable/release-8.5.4/ 新架构是 v8.5.4 引入的，有点矛盾。

ti-chi-bot · 2026-04-03T10:15:20Z

@wlwilliamx: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name	Commit	Details	Required	Rerun command
pull-verify	`8dc0365`	link	true	`/test pull-verify`

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

ticdc: clarify old-architecture rolling upgrade guidance

1185aad

wlwilliamx added the area/ticdc Indicates that the Issue or PR belongs to the area of TiCDC. label Apr 1, 2026

ti-chi-bot bot added missing-translation-status This PR does not have translation status info. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Apr 1, 2026

update

4d737b9

ti-chi-bot bot added size/S Denotes a PR that changes 10-29 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Apr 1, 2026

wlwilliamx added 4 commits April 1, 2026 15:41

add newarch

e28114c

update tiup

02a573f

update

8f25f21

update

44d4c1a

wlwilliamx changed the title ~~ticdc: clarify old-architecture rolling upgrade guidance~~ ticdc: clarify rolling upgrade guidance Apr 1, 2026

flowbehappy reviewed Apr 1, 2026

View reviewed changes

update

5c739b7

flowbehappy approved these changes Apr 1, 2026

View reviewed changes

lilin90 self-assigned this Apr 2, 2026

lilin90 added the translation/doing This PR’s assignee is translating this PR. label Apr 2, 2026

ti-chi-bot bot removed the missing-translation-status This PR does not have translation status info. label Apr 2, 2026

lilin90 requested review from hfxsd and lilin90 April 2, 2026 03:01

hfxsd reviewed Apr 2, 2026

View reviewed changes

ticdc/ticdc-compatibility.md Outdated Show resolved Hide resolved

hfxsd reviewed Apr 2, 2026

View reviewed changes

ticdc/ticdc-compatibility.md Outdated Show resolved Hide resolved

hfxsd reviewed Apr 2, 2026

View reviewed changes

upgrade-tidb-using-tiup.md Outdated Show resolved Hide resolved

lidezhu reviewed Apr 2, 2026

View reviewed changes

Apply suggestions from code review

6d1e2e5

Co-authored-by: xixirangrang <hfxsd@hotmail.com> Co-authored-by: lidezhu <47731263+lidezhu@users.noreply.github.com>

lidezhu reviewed Apr 3, 2026

View reviewed changes

ticdc/ticdc-compatibility.md Outdated Show resolved Hide resolved

upgrade-tidb-using-tiup.md Outdated Show resolved Hide resolved

Apply suggestions from code review

101613a

Co-authored-by: lidezhu <47731263+lidezhu@users.noreply.github.com>

ti-chi-bot bot added size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. and removed size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Apr 3, 2026

lilin90 reviewed Apr 3, 2026

View reviewed changes

lilin90 added 3 commits April 3, 2026 18:10

Update format

1957868

Update wording

02d9421

Update format

8dc0365


		## 历史版本升级的兼容性说明

		TiCDC 依赖 TiDB、TiKV 和 PD 提供的上游变更数据及相关接口。随着 TiDB 及相关产品持续演进，这些数据格式和接口可能发生变化。因此，TiCDC 不对与更高版本 TiDB/TiKV/PD 的跨版本混部提供正式的向上兼容性保证。

Conversation

wlwilliamx commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What is changed, added or deleted? (Required)

Which TiDB version(s) do your changes apply to? (Required)

What is the related PR or file link(s)?

Do your changes match any of the following descriptions?

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

wlwilliamx commented Apr 1, 2026

Uh oh!

ti-chi-bot bot commented Apr 1, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ti-chi-bot bot commented Apr 3, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ti-chi-bot bot commented Apr 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

wlwilliamx commented Apr 1, 2026 •

edited

Loading