Skip to content

TiCDC: Clarify MySQL sink changefeed split table requirements - #21975

Open
wk989898 wants to merge 1 commit into
masterfrom
wk989898-patch-2
Open

wk989898 wants to merge 1 commit into
masterfrom
wk989898-patch-2

Conversation

@wk989898

@wk989898 wk989898 commented Oct 13, 2026 •

Copy link
Copy Markdown
Collaborator

Updated the requirements for MySQL Sink Changefeed to specify that a clustered index is needed for table splitting and distribution.

First-time contributors' checklist

What is changed, added, or deleted? (Required)

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 (in Chinese).

  • 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)?

  • Related code change PR links (if applicable):
  • This PR is translated from:
  • Other reference 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

Summary by CodeRabbit

  • 文档
    • 更新 MySQL Sink 表级任务拆分条件:表除满足至少一项拆分条件外,还须包含聚簇索引;不再要求恰有一个主键或非空唯一键。

Updated the requirements for MySQL Sink Changefeed to specify that a clustered index is needed for table splitting and distribution.
@ti-chi-bot

ti-chi-bot Bot commented Oct 13, 2026

Copy link
Copy Markdown

[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 assign tangenta for approval. 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:

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 missing-translation-status This PR does not have translation status info. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Oct 13, 2026
@coderabbitai

coderabbitai Bot commented Oct 13, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

📝 Walkthrough

文档更新了 MySQL Sink 的表级任务拆分条件:表除满足任一拆分条件外,还必须含有聚簇索引。原有的主键或非空唯一键数量要求已移除。

Changes: MySQL Sink 表级任务拆分

层 / 文件 摘要
更新表级任务拆分条件
ticdc/ticdc-architecture.md
将附加条件从“有且仅有一个主键或非空唯一键”改为“含有聚簇索引”。

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~5 minutes

Change: Other

Merge Risk: 🔵 Low · up to b9ec5

This documentation change clarifies the clustered index requirement for table splitting. One small wording fix remains, and merging carries negligible risk.

### Architecture Summary

Architecture risk: 🔵 Low · up to b9ec5

The change affects 1 system.

Changed systems: ticdc

Architecture concerns
No architecture-level concerns identified.

Review details

Systems and components

  • observed — ticdc (service) was modified; 1 changed file maps to changed impact.

Before / after behavior

  • observed — Modified behavior in ticdc/ticdc-architecture.md: MySQL Sink 表级任务拆分的附加条件从“有且仅有一个主键或非空唯一键”改为“含有聚簇索引”。
Pre-merge checks · Passed 5
Passed 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. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
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 MySQL Sink Changefeed 的表拆分要求。
Description check Passed 描述说明了聚簇索引要求,并勾选了适用版本。虽然“什么被修改”章节未填写正文,但开头摘要已提供相关变更信息,整体内容基本完整。
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

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.

@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: Repository: pingcap/docs-cn/.coderabbit.yaml
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: 97f5b35a-185d-4d00-8fad-f4c8beff2633
📥 Commits

Reviewing files that changed from the base of the PR and between ade7687 and b9ec51a.

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

Included review availability: This review used your included allowance. Your plan provides up to 4 included reviews per hour; 3 remain after this review.

> **注意:**
>
> 针对 MySQL Sink 的 Changefeed,除了满足上述任一条件,表还需要满足**有且仅有一个主键或非空唯一键**,才可以被 TiCDC 拆分并分发,以保证表级任务拆分模式下数据同步的正确性。
> 针对 MySQL Sink 的 Changefeed,除了满足上述任一条件,表还需要满足含有[**聚簇索引**](https://docs.pingcap.com/zh/tidb/stable/clustered-indexes/#%E8%81%9A%E7%B0%87%E7%B4%A2%E5%BC%95),才可以被 TiCDC 拆分并分发,以保证表级任务拆分模式下数据同步的正确性。

@coderabbitai coderabbitai Bot Oct 13, 2026 •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

修正“满足含有”的搭配。

“表还需要满足含有聚簇索引”语法不通。请改为“表还需要包含聚簇索引”。

As per path instructions,**/*.md 要求对可由连续改动行安全、完整修复的问题提供精确替换文本。

> 针对 MySQL Sink 的 Changefeed,除了满足上述任一条件,表还需要包含[**聚簇索引**](https://docs.pingcap.com/zh/tidb/stable/clustered-indexes/#%E8%81%9A%E7%B0%87%E7%B4%A2%E5%BC%95),才可以被 TiCDC 拆分并分发,以保证表级任务拆分模式下数据同步的正确性。
🧰 Tools
🪛 LanguageTool

[uncategorized] ~67-~67: 数词与名词之间一般应存在量词,可能缺少量词。
Context: ...* > > 针对 MySQL Sink 的 Changefeed,除了满足上述任一条件,表还需要满足含有[聚簇索引](https://docs.pingcap...

(wa5)

Source: Path instructions

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

可以按照这个 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.

@asddongmen,将按这条评论修改措辞,保留聚簇索引要求和现有链接。

  • 在 ticdc/ticdc-architecture.md 中,将“表还需要满足含有”改为“表还需要包含”。
  • 不修改其他内容。

  • 📌 Create a pull request with these changes

You are interacting with an AI system.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

missing-translation-status This PR does not have translation status info. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants