Skip to content

master: update TiCDC Debezium DDL, WATERMARK support - #21884

Merged
ti-chi-bot[bot] merged 7 commits into
pingcap:masterfrom
lilin90:copilot/fix-ticdc-debezium-protocol-23470
Aug 17, 2026
Merged

master: update TiCDC Debezium DDL, WATERMARK support#21884
ti-chi-bot[bot] merged 7 commits into
pingcap:masterfrom
lilin90:copilot/fix-ticdc-debezium-protocol-23470

Conversation

@lilin90

@lilin90 lilin90 commented Aug 13, 2026

Copy link
Copy Markdown
Member

What is changed, added or deleted? (Required)

Note

The changes to release-8.5 are made in #21885.

The TiCDC Debezium doc incorrectly stated that DDL and WATERMARK events are supported starting in v9.0.0. This update replaces that version claim with an architecture-based reference that matches actual product behavior.

  • Doc correction

    • Update /ticdc/ticdc-debezium.md to remove the incorrect v9.0.0 statement.
    • State that DDL and WATERMARK events are supported in the TiCDC new architecture.
  • Cross-reference cleanup

    • Link the Debezium doc directly to /ticdc/ticdc-architecture.md so the support boundary is defined by architecture, not by an incorrect version marker.
In the [TiCDC new architecture](/ticdc/ticdc-architecture.md), TiCDC supports DDL events and WATERMARK events.

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

Tips for choosing the affected version(s):

By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.

For details, see tips for choosing the affected versions.

  • master (the latest development version)
  • v9.0 (TiDB 9.0 versions)
  • v8.5 (TiDB 8.5 versions)
  • v8.1 (TiDB 8.1 versions)
  • v7.5 (TiDB 7.5 versions)
  • v7.1 (TiDB 7.1 versions)
  • v6.5 (TiDB 6.5 versions)

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

AI agent involvement

  • The changes in this PR were primarily made by an AI agent on behalf of the PR author.

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
  • Fixes #23469

Summary by CodeRabbit

  • 文档
    • 新增 TiCDC 新架构与经典架构的功能差异说明。
    • 明确新架构支持 DDL、DML 和 WATERMARK 事件,经典架构仅支持 Row Changed 事件。
    • 补充经典架构对 DDL 和 WATERMARK 事件的忽略行为及启用新架构的配置要求。
    • 更新 Debezium 事件支持版本信息,加入 TiCDC v8.5.4-release.1。

@lilin90 lilin90 added area/ticdc Indicates that the Issue or PR belongs to the area of TiCDC. needs-cherry-pick-release-8.5 Should cherry pick this PR to release-8.5 branch. needs-ok-to-test Indicates a PR created by contributors and need ORG member send '/ok-to-test' to start testing. ONCALL Relates to documentation oncall. requires-version-specific-changes After cherry-picked, the cherry-picked PR requires further changes. translation/from-docs This PR is translated from a PR in pingcap/docs. labels Aug 13, 2026
@ti-chi-bot ti-chi-bot Bot added the size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. label Aug 13, 2026
@lilin90 lilin90 self-assigned this Aug 13, 2026
@lilin90 lilin90 removed the needs-ok-to-test Indicates a PR created by contributors and need ORG member send '/ok-to-test' to start testing. label Aug 13, 2026
Synced from: pingcap/docs#23470
Target PR: pingcap#21884

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
@github-actions

Copy link
Copy Markdown

Auto-sync completed successfully

Source PR: pingcap/docs#23470
Target PR: #21884

Chinese documentation has been updated based on English documentation changes.

@ti-chi-bot ti-chi-bot Bot added size/S Denotes a PR that changes 10-29 lines, ignoring generated files. and removed size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Aug 13, 2026
@coderabbitai

coderabbitai Bot commented Aug 13, 2026

Copy link
Copy Markdown

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 305c0311-ee3a-4421-b875-7c82d92d0f55

📥 Commits

Reviewing files that changed from the base of the PR and between 61d3cd8 and ed7ce3a.

📒 Files selected for processing (1)
  • ticdc/ticdc-debezium.md

📝 Walkthrough

Walkthrough

本次更新 TiCDC Debezium 文档,区分新架构与经典架构的事件支持范围,并补充 TiCDC v8.5.4-release.1 的新架构支持说明。

Changes

TiCDC Debezium 文档

Layer / File(s) Summary
架构与事件支持说明
ticdc/ticdc-debezium.md
补充 newarch 启用条件和 TiCDC v8.5.4-release.1 版本说明。新架构支持 DDL、DML 和 WATERMARK 事件;经典架构仅处理 Row Changed 事件,并忽略 DDL 与 WATERMARK 事件。

Estimated code review effort: 1 (简单) | ~5 分钟

Mergeability Score: 🟡 Moderate · up to ed7ce

The documentation still presents v9.0.0 as the support threshold for DDL and WATERMARK events, which can mislead users about TiCDC compatibility. The PR is not merge-ready until this conflicting version statement is corrected.

Possibly related issues

  • pingcap/docs#23469:该 Issue 涉及 TiCDC Debezium 的 DDL/WATERMARK 支持说明及 v8.5.4-release.1 版本范围。

Suggested reviewers: qiancai

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed 标题准确概括了 TiCDC Debezium 文档中 DDL 和 WATERMARK 支持说明的更新。
Description check ✅ Passed 描述包含变更内容、适用版本、相关链接、AI 参与情况和分支处理信息,内容基本完整。
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Comment thread ticdc/ticdc-debezium.md Outdated

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 8f5a8bb9-35bf-437f-9518-9dca0b746172

📥 Commits

Reviewing files that changed from the base of the PR and between 26f202b and a780b87.

📒 Files selected for processing (1)
  • ticdc/ticdc-debezium.md

Comment thread ticdc/ticdc-debezium.md Outdated
Comment thread ticdc/ticdc-debezium.md Outdated
Comment thread ticdc/ticdc-debezium.md Outdated
Comment thread ticdc/ticdc-debezium.md Outdated
Comment thread ticdc/ticdc-debezium.md Outdated
Comment thread ticdc/ticdc-debezium.md Outdated
Comment thread ticdc/ticdc-debezium.md Outdated
@lilin90 lilin90 removed the needs-cherry-pick-release-8.5 Should cherry pick this PR to release-8.5 branch. label Aug 13, 2026
@lilin90
lilin90 marked this pull request as draft August 13, 2026 10:31
@ti-chi-bot ti-chi-bot Bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Aug 13, 2026
@lilin90 lilin90 removed the requires-version-specific-changes After cherry-picked, the cherry-picked PR requires further changes. label Aug 13, 2026
@ti-chi-bot ti-chi-bot Bot added size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. and removed size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Aug 14, 2026
@lilin90
lilin90 marked this pull request as ready for review August 14, 2026 07:51
@ti-chi-bot ti-chi-bot Bot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Aug 14, 2026
@lilin90
lilin90 requested a review from qiancai August 14, 2026 07:51
@lilin90 lilin90 changed the title ticdc: update TiCDC Debezium DDL, WATERMARK support master: update TiCDC Debezium DDL, WATERMARK support Aug 14, 2026
@ti-chi-bot ti-chi-bot Bot added the needs-1-more-lgtm Indicates a PR needs 1 more LGTM. label Aug 14, 2026
@ti-chi-bot

ti-chi-bot Bot commented Aug 14, 2026

Copy link
Copy Markdown

[LGTM Timeline notifier]

Timeline:

  • 2026-08-14 07:58:12.163076292 +0000 UTC m=+3378878.199171358: ☑️ agreed by qiancai.

Comment thread ticdc/ticdc-debezium.md Outdated
Co-authored-by: Grace Cai <qqzczy@126.com>
@ti-chi-bot

ti-chi-bot Bot commented Aug 14, 2026

Copy link
Copy Markdown

@wk989898: 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.

@lilin90 lilin90 added the lgtm label Aug 14, 2026
@lilin90

lilin90 commented Aug 14, 2026

Copy link
Copy Markdown
Member Author

/approve

@ti-chi-bot

ti-chi-bot Bot commented Aug 14, 2026

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: lilin90

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

The pull request process is described here

Details Needs approval from an approver in each of these files:

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

@ti-chi-bot ti-chi-bot Bot added the approved label Aug 14, 2026
@lilin90

lilin90 commented Aug 17, 2026

Copy link
Copy Markdown
Member Author

/retest

@ti-chi-bot
ti-chi-bot Bot merged commit 41add7f into pingcap:master Aug 17, 2026
11 checks passed
@lilin90
lilin90 deleted the copilot/fix-ticdc-debezium-protocol-23470 branch August 17, 2026 03:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved area/ticdc Indicates that the Issue or PR belongs to the area of TiCDC. lgtm needs-1-more-lgtm Indicates a PR needs 1 more LGTM. ONCALL Relates to documentation oncall. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. translation/from-docs This PR is translated from a PR in pingcap/docs.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants