From 36b5c42bc12f5e9d5097335a695c5be079b6f96b Mon Sep 17 00:00:00 2001 From: hongyunyan <649330952@qq.com> Date: Wed, 25 Feb 2026 09:08:15 +0800 Subject: [PATCH 01/11] update --- ticdc/ticdc-architecture.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index 6bf05719e495..83ba385f5708 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -66,6 +66,16 @@ TiCDC 新架构通过将整体架构拆分成有状态和无状态的两部分 > > 针对 MySQL Sink 的 Changefeed，除了满足上述任一条件，表还需要满足**有且仅有一个主键或非空唯一键**，才可以被 TiCDC 拆分并分发，以保证拆表模式下数据同步的正确性。 +### 拆表模式配置建议 + +切换到 TiCDC 新架构后，不建议继续沿用老架构中的拆表相关配置项。在绝大多数场景下，建议先使用新架构的默认配置值，仅在特殊场景下再基于新架构默认值进行小幅微调。 + +拆表模式下建议重点关注以下配置项： + +- `scheduler.region-threshold`：默认值为 `10000`。当表中的 Region 个数大于该阈值时，TiCDC 会对该表执行拆分。对于 Region 数量较少但表整体流量较大的场景，建议适当调小该值。但该值不能小于 `scheduler.region-count-per-span`，否则可能导致任务反复调度并引起同步延迟上升。 +- `scheduler.region-count-per-span`：默认值为 `100`。在 Changefeed 初始化过程中，满足拆分条件的表会按该参数进行拆分，使拆分后的每个子表最多包含 `region-count-per-span` 个 Region。 +- `scheduler.write-key-threshold`：默认值为 `0`（默认关闭）。当表的 Sink 写入流量超过该阈值时，TiCDC 会对该表执行拆分。不建议将该参数设置为非 `0` 值。 + ## 兼容性说明 ### DDL 进度表 From 3a8c6ed8dcccad805e72782dfd1b5db6eb0dbb58 Mon Sep 17 00:00:00 2001 From: xixirangrang Date: Wed, 25 Feb 2026 20:46:51 +0800 Subject: [PATCH 02/11] Update ticdc/ticdc-architecture.md --- ticdc/ticdc-architecture.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index 83ba385f5708..146adab09b8b 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -68,13 +68,13 @@ TiCDC 新架构通过将整体架构拆分成有状态和无状态的两部分 ### 拆表模式配置建议 -切换到 TiCDC 新架构后，不建议继续沿用老架构中的拆表相关配置项。在绝大多数场景下，建议先使用新架构的默认配置值，仅在特殊场景下再基于新架构默认值进行小幅微调。 +切换至 TiCDC 新架构后，不建议继续使用老架构中的拆表相关配置。在绝大多数场景下，建议先采用新架构的默认配置。仅在特殊场景下，再基于默认值进行小幅调整。 -拆表模式下建议重点关注以下配置项： +在拆表模式下，建议重点关注以下配置项： -- `scheduler.region-threshold`：默认值为 `10000`。当表中的 Region 个数大于该阈值时，TiCDC 会对该表执行拆分。对于 Region 数量较少但表整体流量较大的场景，建议适当调小该值。但该值不能小于 `scheduler.region-count-per-span`，否则可能导致任务反复调度并引起同步延迟上升。 -- `scheduler.region-count-per-span`：默认值为 `100`。在 Changefeed 初始化过程中，满足拆分条件的表会按该参数进行拆分，使拆分后的每个子表最多包含 `region-count-per-span` 个 Region。 -- `scheduler.write-key-threshold`：默认值为 `0`（默认关闭）。当表的 Sink 写入流量超过该阈值时，TiCDC 会对该表执行拆分。不建议将该参数设置为非 `0` 值。 +- `scheduler.region-threshold`：默认值为 `10000`。当表的 Region 数量超过该阈值时，TiCDC 会对该表执行拆分。对于 Region 数量较少但表整体写入流量较高的场景，可以适当降低该值。该参数必须大于或等于 `scheduler.region-count-per-span`，否则可能导致任务频繁调度，并增加同步延迟。 +- `scheduler.region-count-per-span`：默认值为 `100`。在 Changefeed 初始化阶段，满足拆分条件的表会按照该参数进行拆分。拆分后，每个子表最多包含 `region-count-per-span` 个 Region。 +- `scheduler.write-key-threshold`：默认值为 `0`（表示关闭）。当表的 Sink 写入流量超过该阈值时，TiCDC 会触发拆分。不建议将该参数设置为非 `0` 值。 ## 兼容性说明 From cbfaf9bbf1976ad2e1d1faa04ff1f53dee51a3b9 Mon Sep 17 00:00:00 2001 From: xixirangrang Date: Wed, 25 Feb 2026 20:50:46 +0800 Subject: [PATCH 03/11] Update ticdc/ticdc-architecture.md --- ticdc/ticdc-architecture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index 146adab09b8b..9e7b4c6f7c16 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -74,7 +74,7 @@ TiCDC 新架构通过将整体架构拆分成有状态和无状态的两部分 - `scheduler.region-threshold`：默认值为 `10000`。当表的 Region 数量超过该阈值时，TiCDC 会对该表执行拆分。对于 Region 数量较少但表整体写入流量较高的场景，可以适当降低该值。该参数必须大于或等于 `scheduler.region-count-per-span`，否则可能导致任务频繁调度，并增加同步延迟。 - `scheduler.region-count-per-span`：默认值为 `100`。在 Changefeed 初始化阶段，满足拆分条件的表会按照该参数进行拆分。拆分后，每个子表最多包含 `region-count-per-span` 个 Region。 -- `scheduler.write-key-threshold`：默认值为 `0`（表示关闭）。当表的 Sink 写入流量超过该阈值时，TiCDC 会触发拆分。不建议将该参数设置为非 `0` 值。 +- `scheduler.write-key-threshold`：默认值为 `0`（表示关闭）。当表的 Sink 写入流量超过该阈值时，TiCDC 会触发拆分。建议使用默认值 `0`。 ## 兼容性说明 From 41277a173e166733ab4308d414978cf1e3235a95 Mon Sep 17 00:00:00 2001 From: xixirangrang Date: Thu, 26 Feb 2026 15:48:59 +0800 Subject: [PATCH 04/11] Apply suggestions from code review Co-authored-by: Grace Cai --- ticdc/ticdc-architecture.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index 9e7b4c6f7c16..a40bc06de6f2 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -64,9 +64,9 @@ TiCDC 新架构通过将整体架构拆分成有状态和无状态的两部分 > **注意：** > -> 针对 MySQL Sink 的 Changefeed，除了满足上述任一条件，表还需要满足**有且仅有一个主键或非空唯一键**，才可以被 TiCDC 拆分并分发，以保证拆表模式下数据同步的正确性。 +> 针对 MySQL Sink 的 Changefeed，除了满足上述任一条件，表还需要满足**有且仅有一个主键或非空唯一键**，才可以被 TiCDC 拆分并分发，以保证表级任务拆分模式下数据同步的正确性。 -### 拆表模式配置建议 +### 表级任务拆分配置建议 切换至 TiCDC 新架构后，不建议继续使用老架构中的拆表相关配置。在绝大多数场景下，建议先采用新架构的默认配置。仅在特殊场景下，再基于默认值进行小幅调整。 From 040b311f6862f8495ff28790b96dd86bd3f24cbf Mon Sep 17 00:00:00 2001 From: houfaxin Date: Thu, 26 Feb 2026 15:57:43 +0800 Subject: [PATCH 05/11] Update ticdc-changefeed-config.md --- ticdc/ticdc-changefeed-config.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/ticdc/ticdc-changefeed-config.md b/ticdc/ticdc-changefeed-config.md index 223250931a3c..0fe157e82775 100644 --- a/ticdc/ticdc-changefeed-config.md +++ b/ticdc/ticdc-changefeed-config.md @@ -161,6 +161,11 @@ Info: {"upstream_id":7178706266519722477,"namespace":"default","id":"simple-repl - 默认为 `false`。设置为 `true` 以打开该功能。 - 默认值：`false` +#### `region-count-per-span` + +- 在 Changefeed 初始化阶段，满足拆分条件的表会按照该参数进行拆分。拆分后，每个子表最多包含 `region-count-per-span` 个 Region。 +- 默认值：`100`。 + #### `region-threshold` - 默认值：对于 [TiCDC 新架构](/ticdc/ticdc-architecture.md)，默认值为 `10000`；对于 [TiCDC 老架构](/ticdc/ticdc-classic-architecture.md)，默认值为 `100000`。 From 4dae77785c8fa03815f207cf9724a7c1ce85c335 Mon Sep 17 00:00:00 2001 From: houfaxin Date: Thu, 26 Feb 2026 16:05:31 +0800 Subject: [PATCH 06/11] Update ticdc-architecture.md --- ticdc/ticdc-architecture.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index a40bc06de6f2..6478bd321d94 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -72,9 +72,9 @@ TiCDC 新架构通过将整体架构拆分成有状态和无状态的两部分 在拆表模式下，建议重点关注以下配置项： -- `scheduler.region-threshold`：默认值为 `10000`。当表的 Region 数量超过该阈值时，TiCDC 会对该表执行拆分。对于 Region 数量较少但表整体写入流量较高的场景，可以适当降低该值。该参数必须大于或等于 `scheduler.region-count-per-span`，否则可能导致任务频繁调度，并增加同步延迟。 -- `scheduler.region-count-per-span`：默认值为 `100`。在 Changefeed 初始化阶段，满足拆分条件的表会按照该参数进行拆分。拆分后，每个子表最多包含 `region-count-per-span` 个 Region。 -- `scheduler.write-key-threshold`：默认值为 `0`（表示关闭）。当表的 Sink 写入流量超过该阈值时，TiCDC 会触发拆分。建议使用默认值 `0`。 +- [`scheduler.region-threshold`](/ticdc/ticdc-changefeed-config.md#region-threshold)：默认值为 `10000`。当表的 Region 数量超过该阈值时，TiCDC 会对该表执行拆分。对于 Region 数量较少但表整体写入流量较高的场景，可以适当降低该值。该参数必须大于或等于 `scheduler.region-count-per-span`，否则可能导致任务频繁调度，并增加同步延迟。 +- [`scheduler.region-count-per-span`](/ticdc/ticdc-changefeed-config.md#region-count-per-span)：默认值为 `100`。在 Changefeed 初始化阶段，满足拆分条件的表会按照该参数进行拆分。拆分后，每个子表最多包含 `region-count-per-span` 个 Region。 +- [`scheduler.write-key-threshold`](/ticdc/ticdc-changefeed-config.md#write-key-threshold)：默认值为 `0`（表示关闭）。当表的 Sink 写入流量超过该阈值时，TiCDC 会触发拆分。建议使用默认值 `0`。 ## 兼容性说明 From 08b5a64521dc1f0c052df357d8dd0aef7cd33f0d Mon Sep 17 00:00:00 2001 From: xixirangrang Date: Thu, 26 Feb 2026 16:06:42 +0800 Subject: [PATCH 07/11] Update ticdc/ticdc-architecture.md Co-authored-by: Grace Cai --- ticdc/ticdc-architecture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index 6478bd321d94..42b534a37052 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -68,7 +68,7 @@ TiCDC 新架构通过将整体架构拆分成有状态和无状态的两部分 ### 表级任务拆分配置建议 -切换至 TiCDC 新架构后，不建议继续使用老架构中的拆表相关配置。在绝大多数场景下，建议先采用新架构的默认配置。仅在特殊场景下，再基于默认值进行小幅调整。 +切换至 TiCDC 新架构后，不建议继续使用老架构中的拆表相关配置。在绝大多数场景下，建议先采用新架构的默认配置。仅在存在同步性能瓶颈或调度不均的特殊场景下，再基于默认值进行小幅调整。 在拆表模式下，建议重点关注以下配置项： From 9c1db594f882300d338ea729304a3e24c47731b8 Mon Sep 17 00:00:00 2001 From: xixirangrang Date: Thu, 26 Feb 2026 16:20:10 +0800 Subject: [PATCH 08/11] Update ticdc/ticdc-architecture.md --- ticdc/ticdc-architecture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index 42b534a37052..20b97c08df64 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -74,7 +74,7 @@ TiCDC 新架构通过将整体架构拆分成有状态和无状态的两部分 - [`scheduler.region-threshold`](/ticdc/ticdc-changefeed-config.md#region-threshold)：默认值为 `10000`。当表的 Region 数量超过该阈值时，TiCDC 会对该表执行拆分。对于 Region 数量较少但表整体写入流量较高的场景，可以适当降低该值。该参数必须大于或等于 `scheduler.region-count-per-span`，否则可能导致任务频繁调度，并增加同步延迟。 - [`scheduler.region-count-per-span`](/ticdc/ticdc-changefeed-config.md#region-count-per-span)：默认值为 `100`。在 Changefeed 初始化阶段，满足拆分条件的表会按照该参数进行拆分。拆分后，每个子表最多包含 `region-count-per-span` 个 Region。 -- [`scheduler.write-key-threshold`](/ticdc/ticdc-changefeed-config.md#write-key-threshold)：默认值为 `0`（表示关闭）。当表的 Sink 写入流量超过该阈值时，TiCDC 会触发拆分。建议使用默认值 `0`。 +- [`scheduler.write-key-threshold`](/ticdc/ticdc-changefeed-config.md#write-key-threshold)：默认值为 `0`（表示关闭）。当表的 Sink 写入流量超过该阈值时，TiCDC 会触发拆分。建议保持默认值 `0`。 ## 兼容性说明 From ac73f82040eac3f6274574e0868e5eb2f512b323 Mon Sep 17 00:00:00 2001 From: houfaxin Date: Thu, 26 Feb 2026 16:46:47 +0800 Subject: [PATCH 09/11] Update ticdc-changefeed-config.md --- ticdc/ticdc-changefeed-config.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ticdc/ticdc-changefeed-config.md b/ticdc/ticdc-changefeed-config.md index 0fe157e82775..0d33592a2aed 100644 --- a/ticdc/ticdc-changefeed-config.md +++ b/ticdc/ticdc-changefeed-config.md @@ -161,7 +161,7 @@ Info: {"upstream_id":7178706266519722477,"namespace":"default","id":"simple-repl - 默认为 `false`。设置为 `true` 以打开该功能。 - 默认值：`false` -#### `region-count-per-span` +#### `region-count-per-span` 从 v8.5.4 版本开始引入 - 在 Changefeed 初始化阶段，满足拆分条件的表会按照该参数进行拆分。拆分后，每个子表最多包含 `region-count-per-span` 个 Region。 - 默认值：`100`。 From 7f1dd911bb93ade17b184885cf34460a9f2c8f45 Mon Sep 17 00:00:00 2001 From: houfaxin Date: Thu, 26 Feb 2026 16:49:54 +0800 Subject: [PATCH 10/11] Update ticdc-architecture.md --- ticdc/ticdc-architecture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ticdc/ticdc-architecture.md b/ticdc/ticdc-architecture.md index 20b97c08df64..f2261860fe46 100644 --- a/ticdc/ticdc-architecture.md +++ b/ticdc/ticdc-architecture.md @@ -73,7 +73,7 @@ TiCDC 新架构通过将整体架构拆分成有状态和无状态的两部分 在拆表模式下，建议重点关注以下配置项： - [`scheduler.region-threshold`](/ticdc/ticdc-changefeed-config.md#region-threshold)：默认值为 `10000`。当表的 Region 数量超过该阈值时，TiCDC 会对该表执行拆分。对于 Region 数量较少但表整体写入流量较高的场景，可以适当降低该值。该参数必须大于或等于 `scheduler.region-count-per-span`，否则可能导致任务频繁调度，并增加同步延迟。 -- [`scheduler.region-count-per-span`](/ticdc/ticdc-changefeed-config.md#region-count-per-span)：默认值为 `100`。在 Changefeed 初始化阶段，满足拆分条件的表会按照该参数进行拆分。拆分后，每个子表最多包含 `region-count-per-span` 个 Region。 +- [`scheduler.region-count-per-span`](/ticdc/ticdc-changefeed-config.md#region-count-per-span-从-v854-版本开始引入)：默认值为 `100`。在 Changefeed 初始化阶段，满足拆分条件的表会按照该参数进行拆分。拆分后，每个子表最多包含 `region-count-per-span` 个 Region。 - [`scheduler.write-key-threshold`](/ticdc/ticdc-changefeed-config.md#write-key-threshold)：默认值为 `0`（表示关闭）。当表的 Sink 写入流量超过该阈值时，TiCDC 会触发拆分。建议保持默认值 `0`。 ## 兼容性说明 From f4f04cd29890fbd4541dfc03701c4edd68e495bd Mon Sep 17 00:00:00 2001 From: houfaxin Date: Thu, 26 Feb 2026 16:56:10 +0800 Subject: [PATCH 11/11] Update ticdc-changefeed-config.md --- ticdc/ticdc-changefeed-config.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ticdc/ticdc-changefeed-config.md b/ticdc/ticdc-changefeed-config.md index 0d33592a2aed..6dae6b7f9b27 100644 --- a/ticdc/ticdc-changefeed-config.md +++ b/ticdc/ticdc-changefeed-config.md @@ -163,7 +163,7 @@ Info: {"upstream_id":7178706266519722477,"namespace":"default","id":"simple-repl #### `region-count-per-span` 从 v8.5.4 版本开始引入 -- 在 Changefeed 初始化阶段，满足拆分条件的表会按照该参数进行拆分。拆分后，每个子表最多包含 `region-count-per-span` 个 Region。 +- 在 [TiCDC 新架构](/ticdc/ticdc-architecture.md)中引入。在 Changefeed 初始化阶段，满足拆分条件的表会按照该参数进行拆分。拆分后，每个子表最多包含 `region-count-per-span` 个 Region。 - 默认值：`100`。 #### `region-threshold`