[doc-claw-bot]

What is changed, added or deleted? (Required)

• Fix the DM shard-merge example so the DDL-only event filter no longer includes the delete DML event.
• Update the Chinese binlog-schema update example to match the current positional-argument syntax.
• Clarify how to handle SQL statements that TiDB does not support or that DM cannot parse, including the partition-filter example and global-filter warning.

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

• master (the latest development version)
• v8.5 (TiDB 8.5 versions)
• v8.4 (TiDB 8.4 versions)
• v8.3 (TiDB 8.3 versions)
• v8.2 (TiDB 8.2 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)?

• This PR is translated from: docs(dm): fix stale event-filter and binlog-schema examples docs#24598
• Other reference link(s):
  • https://docs.pingcap.com/tidb/stable/migrate-small-mysql-shards-to-tidb
  • https://docs.pingcap.com/tidb/stable/migrate-with-more-columns-downstream
  • https://docs.pingcap.com/tidb/stable/filter-binlog-event
  • https://docs.pingcap.com/tidb/stable/dm-binlog-event-filter

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

• 文档
  • 更新 SQL 过滤说明：DM 会自动跳过 CREATE PROCEDURE、DROP PROCEDURE 和 ALTER PROCEDURE；DM 与 TiDB 均支持的分区操作无需配置过滤规则。对于导致解析错误且无需同步的分区语句，可配置全局忽略规则，并注意谨慎使用。
  • 更新迁移指南：过滤规则不再忽略 delete 事件，仍忽略 truncate table 和 drop table。
  • 更新 binlog-schema update 示例，改用位置参数传入数据库名、表名和 schema 文件。

[coderabbitai]

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.

• Last reviewed commit: 9c7638d
• Latest commit, not reviewed: a207da5

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

Walkthrough

本次更新 DM 文档中的过滤规则说明和配置示例，并调整 binlog-schema update 命令示例的参数写法。

Changes: 过滤规则说明

Layer / File(s)	Summary
Binlog 事件过滤说明 filter-binlog-event.md	文档说明 DM 自动跳过 CREATE PROCEDURE、DROP PROCEDURE 和 ALTER PROCEDURE。DM 与 TiDB 均支持的分区操作无需配置过滤规则。若 DM 解析含 ADD PARTITION 或 DROP PARTITION 的 ALTER TABLE 时出错，且无需同步该变更，示例使用全局规则忽略语句。
分片迁移过滤规则 migrate-small-mysql-shards-to-tidb.md	过滤规则说明改为针对部分不兼容的 DDL 事件。sale-filter-rule 不再忽略 delete，仍忽略 truncate table 和 drop table。

Schema 更新命令示例

Layer / File(s)	Summary
命令参数示例 migrate-with-more-columns-downstream.md	binlog-schema update 示例改用位置参数传入数据库名、表名和 schema 文件。

Priority: Normal

Estimated code review effort: 2 (Simple) | ~10 minutes

Change: Other

Suggested reviewers: qiancai

Merge Risk: Moderate · previous review 9c763

A global filter may skip valid schema changes, and conflicting procedure guidance may lead users to configure ineffective filters; resolve these before merging.

Pre-merge checks: 5

Check name	Status	Explanation
Title check		标题准确概括了本次文档更新，涵盖事件过滤规则和 binlog-schema 示例修正，简洁且明确。
Description check		描述包含变更内容、适用版本、相关链接、AI agent 信息和变更类型检查项。内容与 PR 目标一致，满足模板要求。
Docstring Coverage		No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentat…
Linked Issues check		Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check		Check skipped because no linked issues were found for this pull request.

Full details: Docstring Coverage

Explanation

No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentation-only edits and deletions within surviving functions are included; unchanged diff context and fully deleted functions are excluded. Analyzed 0 functions across 0 files. (1 skipped: 1 unsupported.)

Finishing Touches

🧪 Generate unit tests (beta)

• 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

• X
• Mastodon
• Reddit
• LinkedIn

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

[pingcap-cla-assistant]

All committers have signed the CLA.

[coderabbitai]

Actionable comments posted: 1

---

Review info

Run configuration

• Source mode: Auto
• Repository: pingcap/docs-cn
• Branch: master
• File: .coderabbit.yaml
• Commit: 9f466f0
• Layers: Repository YAML
• Review profile: ASSERTIVE
• Plan: Advanced
• Run ID: f4f73127-18ef-4191-9266-b66b7fa71f2f

Commits

Reviewing files that changed from the base of the PR and between 9f466f0 and 7c93b79.

Files selected for processing: 3

• filter-binlog-event.md
• migrate-small-mysql-shards-to-tidb.md
• migrate-with-more-columns-downstream.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.

[qiancai]

“dm/dm-manage-schema.md" is not included in this PR because it is already correct and up to date as pingcap/docs#24598

[coderabbitai]

Caution

Some comments are outside the diff and can’t be posted inline due to GitHub limitations.

⚠️ Outside diff range comments (1)

Minor · 同步存储过程过滤说明。 · filter-binlog-event.md:101

filter-binlog-event.md:101
Minor · Functional Correctness · Quick win

同步存储过程过滤说明。

filter-binlog-event.md 说明无需为 CREATE PROCEDURE、DROP PROCEDURE 和 ALTER PROCEDURE 配置过滤规则，但 dm/dm-binlog-event-filter.md 仍建议过滤 CREATE PROCEDURE 和 DROP PROCEDURE，且未覆盖 ALTER PROCEDURE。请删除或改写 dm/dm-binlog-event-filter.md 中的旧示例；如果两个文档面向不同版本，请明确版本范围。

---

Review info

Run configuration

• Source mode: Auto
• Repository: pingcap/docs-cn
• Branch: master
• File: .coderabbit.yaml
• Commit: 9f466f0
• Layers: Repository YAML
• Review profile: ASSERTIVE
• Plan: Advanced
• Run ID: dc423390-49b0-4fba-984b-a1628a2a14c6

Commits

Reviewing files that changed from the base of the PR and between 39e6096 and 9c7638d.

Files selected for processing: 1

• filter-binlog-event.md

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

[ti-chi-bot]

[LGTM Timeline notifier]

Timeline:

• 2026-10-30 10:30:08.062672054 +0000 UTC m=+230532.687822306: ☑️ agreed by qiancai.

[qiancai]

/approve

[ti-chi-bot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: qiancai

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:

• OWNERS [qiancai]

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]

In response to a cherrypick label: new pull request created to branch release-8.1: #22021.

[ti-chi-bot]

In response to a cherrypick label: new pull request created to branch release-8.5: #22022.