From f53b45f7506a135a95565af86ffdab793f183fb4 Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Thu, 13 Aug 2026 17:13:35 +0800 Subject: [PATCH 1/7] Create empty translation PR From a780b875e1a0d8843a2a5e884bf3f4882895b780 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Thu, 13 Aug 2026 09:14:53 +0000 Subject: [PATCH 2/7] Auto-sync: Update Chinese docs from English PR Synced from: https://github.com/pingcap/docs/pull/23470 Target PR: https://github.com/pingcap/docs-cn/pull/21884 Co-authored-by: github-actions[bot] --- ticdc/ticdc-debezium.md | 27 ++++++++++++++++++++++++--- 1 file changed, 24 insertions(+), 3 deletions(-) diff --git a/ticdc/ticdc-debezium.md b/ticdc/ticdc-debezium.md index ae64f8af69c9..104d3f2744dd 100644 --- a/ticdc/ticdc-debezium.md +++ b/ticdc/ticdc-debezium.md @@ -5,18 +5,31 @@ summary: 了解 TiCDC Debezium Protocol 的概念和使用方法。 # TiCDC Debezium Protocol -[Debezium](https://debezium.io/) 是一个用于捕获数据库变更的工具。它会将捕获的数据库变更的每一条记录转化为一个被称为“事件” (event) 的消息 (message)，并将这些事件发送到 Kafka 中。从 v8.0.0 起，TiCDC 支持将 TiDB 的变更以 Debezium 的格式直接传输到 Kafka，为之前使用 Debezium 的 MySQL 集成的用户简化了从 MySQL 数据库迁移的过程。从 v9.0.0 起，TiCDC 支持 DDL 事件和 WATERMARK 事件。 +[Debezium](https://debezium.io/) 是一个用于捕获数据库变更的工具。它会将捕获的数据库变更的每一条记录转化为一个被称为“事件” (event) 的消息 (message)，并将这些事件发送到 Kafka 中。从 v8.0.0 起，TiCDC 支持将 TiDB 的变更以 Debezium 的格式直接传输到 Kafka，为之前使用 Debezium 的 MySQL 集成的用户简化了从 MySQL 数据库迁移的过程。从 [TiCDC v8.5.4-release.1](https://github.com/pingcap/ticdc/releases/tag/v8.5.4-release.1)（[新 TiCDC 架构](/ticdc/ticdc-architecture.md)）和 v9.0.0 起，TiCDC 支持 DDL 事件和 WATERMARK 事件。 ## 使用 Debezium 消息格式 当使用 Kafka 作为下游 Sink 时，你可以将 `sink-uri` 的 `protocol` 字段指定为 `debezium`，TiCDC 将以 event 为基本单位封装构造 Debezium 消息，向下游发送 TiDB 的数据变更事件。 + +
+ +要使用新 TiCDC 架构，请将 TiCDC 配置项 [`newarch`](/ticdc/ticdc-server-config.md#newarch-从-v854-版本开始引入-release1) 设置为 `true`。 + Debezium 协议支持以下类型的事件： - DDL 事件：表示 DDL 变更记录。在上游 DDL 语句成功执行后，DDL 事件被发送到每个 MQ (Message Queue) 分区。 - DML 事件：表示一行数据变更记录。在行变更发生时，DML 事件被发出，包含变更后该行的相关信息。 - WATERMARK 事件：表示一个特殊的时间点。在这个时间点之前收到的事件是完整的。仅适用于 TiDB 扩展字段，当你在 `sink-uri` 中设置 [`enable-tidb-extension`](/ticdc/ticdc-sink-to-kafka.md#sink-uri-配置-kafka) 为 `true` 时生效。 +
+
+ +Debezium 协议仅支持 Row Changed 事件，并会直接忽略 DDL 事件和 WATERMARK 事件。Row changed 事件表示一行中的数据变更。当某一行发生变更时，会发送 Row Changed 事件，其中包含该行变更前后的相关信息。WATERMARK 事件标记表的复制进度，表示所有早于该 watermark 的事件都已发送到下游。 + +
+ + 使用 Debezium 消息格式时的配置样例如下所示： ```shell @@ -31,7 +44,11 @@ Debezium 输出格式中包含当前行的 Schema 信息，以便下游消费者 本节介绍 DDL 事件、DML 事件和 WATERMARK 事件的消息格式。 -### DDL 事件 +### DDL 事件（新 TiCDC 架构） + +> **注意：** +> +> DDL 事件仅在[新 TiCDC 架构](/ticdc/ticdc-architecture.md)中受支持。在[经典 TiCDC 架构](/ticdc/ticdc-classic-architecture.md)中，DDL 事件会被忽略。 TiCDC 会将一个 DDL 事件转换为一条 Kafka 消息，其中消息的 key 和 value 都按照 Debezium 协议进行编码。 @@ -578,7 +595,11 @@ Key 中的字段只包含主键或唯一索引列。字段解释如下： | `schema.optional` | 布尔值 | 该字段是否为选填项。值为 `true` 表示该字段为选填项。 | | `schema.type` | 字符串 | 字段的类型。 | -### WATERMARK 事件 +### WATERMARK 事件（新 TiCDC 架构） + +> **注意：** +> +> WATERMARK 事件仅在[新 TiCDC 架构](/ticdc/ticdc-architecture.md)中受支持。在[经典 TiCDC 架构](/ticdc/ticdc-classic-architecture.md)中，WATERMARK 事件会被忽略。 TiCDC 会将一个 WATERMARK 事件转换为一条 Kafka 消息，其中消息的 key 和 value 都按照 Debezium 协议进行编码。 From 61d3cd88e5d627274a2d338bcdc67a149c202b60 Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Thu, 13 Aug 2026 17:20:15 +0800 Subject: [PATCH 3/7] Apply suggestions from code review --- ticdc/ticdc-debezium.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/ticdc/ticdc-debezium.md b/ticdc/ticdc-debezium.md index 104d3f2744dd..4658692ca00a 100644 --- a/ticdc/ticdc-debezium.md +++ b/ticdc/ticdc-debezium.md @@ -5,16 +5,16 @@ summary: 了解 TiCDC Debezium Protocol 的概念和使用方法。 # TiCDC Debezium Protocol -[Debezium](https://debezium.io/) 是一个用于捕获数据库变更的工具。它会将捕获的数据库变更的每一条记录转化为一个被称为“事件” (event) 的消息 (message)，并将这些事件发送到 Kafka 中。从 v8.0.0 起，TiCDC 支持将 TiDB 的变更以 Debezium 的格式直接传输到 Kafka，为之前使用 Debezium 的 MySQL 集成的用户简化了从 MySQL 数据库迁移的过程。从 [TiCDC v8.5.4-release.1](https://github.com/pingcap/ticdc/releases/tag/v8.5.4-release.1)（[新 TiCDC 架构](/ticdc/ticdc-architecture.md)）和 v9.0.0 起，TiCDC 支持 DDL 事件和 WATERMARK 事件。 +[Debezium](https://debezium.io/) 是一个用于捕获数据库变更的工具。它会将捕获的数据库变更的每一条记录转化为一个被称为“事件” (event) 的消息 (message)，并将这些事件发送到 Kafka 中。从 v8.0.0 起，TiCDC 支持将 TiDB 的变更以 Debezium 的格式直接传输到 Kafka，为之前使用 Debezium 的 MySQL 集成的用户简化了从 MySQL 数据库迁移的过程。从 [TiCDC v8.5.4-release.1](https://github.com/pingcap/ticdc/releases/tag/v8.5.4-release.1)（[TiCDC 新架构](/ticdc/ticdc-architecture.md)）和 v9.0.0 起，TiCDC 支持 DDL 事件和 WATERMARK 事件。 ## 使用 Debezium 消息格式 当使用 Kafka 作为下游 Sink 时，你可以将 `sink-uri` 的 `protocol` 字段指定为 `debezium`，TiCDC 将以 event 为基本单位封装构造 Debezium 消息，向下游发送 TiDB 的数据变更事件。 -
+
-要使用新 TiCDC 架构，请将 TiCDC 配置项 [`newarch`](/ticdc/ticdc-server-config.md#newarch-从-v854-版本开始引入-release1) 设置为 `true`。 +要使用 TiCDC 新架构，请将 TiCDC 配置项 [`newarch`](/ticdc/ticdc-server-config.md#newarch-从-v854-版本开始引入-release1) 设置为 `true`。 Debezium 协议支持以下类型的事件： @@ -23,7 +23,7 @@ Debezium 协议支持以下类型的事件： - WATERMARK 事件：表示一个特殊的时间点。在这个时间点之前收到的事件是完整的。仅适用于 TiDB 扩展字段，当你在 `sink-uri` 中设置 [`enable-tidb-extension`](/ticdc/ticdc-sink-to-kafka.md#sink-uri-配置-kafka) 为 `true` 时生效。
-
+
Debezium 协议仅支持 Row Changed 事件，并会直接忽略 DDL 事件和 WATERMARK 事件。Row changed 事件表示一行中的数据变更。当某一行发生变更时，会发送 Row Changed 事件，其中包含该行变更前后的相关信息。WATERMARK 事件标记表的复制进度，表示所有早于该 watermark 的事件都已发送到下游。 @@ -44,7 +44,7 @@ Debezium 输出格式中包含当前行的 Schema 信息，以便下游消费者 本节介绍 DDL 事件、DML 事件和 WATERMARK 事件的消息格式。 -### DDL 事件（新 TiCDC 架构） +### DDL 事件（TiCDC 新架构） > **注意：** > @@ -595,7 +595,7 @@ Key 中的字段只包含主键或唯一索引列。字段解释如下： | `schema.optional` | 布尔值 | 该字段是否为选填项。值为 `true` 表示该字段为选填项。 | | `schema.type` | 字符串 | 字段的类型。 | -### WATERMARK 事件（新 TiCDC 架构） +### WATERMARK 事件（TiCDC 新架构） > **注意：** > From ed7ce3aa1a5deb7a51b689a1262594d51e25c228 Mon Sep 17 00:00:00 2001 From: lilin90 Date: Thu, 13 Aug 2026 17:23:42 +0800 Subject: [PATCH 4/7] Update wording --- ticdc/ticdc-debezium.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ticdc/ticdc-debezium.md b/ticdc/ticdc-debezium.md index 4658692ca00a..ab900b79b9c4 100644 --- a/ticdc/ticdc-debezium.md +++ b/ticdc/ticdc-debezium.md @@ -48,7 +48,7 @@ Debezium 输出格式中包含当前行的 Schema 信息，以便下游消费者 > **注意：** > -> DDL 事件仅在[新 TiCDC 架构](/ticdc/ticdc-architecture.md)中受支持。在[经典 TiCDC 架构](/ticdc/ticdc-classic-architecture.md)中，DDL 事件会被忽略。 +> DDL 事件仅在 [TiCDC 新架构](/ticdc/ticdc-architecture.md)中受支持。在 [TiCDC 老架构](/ticdc/ticdc-classic-architecture.md)中，DDL 事件会被忽略。 TiCDC 会将一个 DDL 事件转换为一条 Kafka 消息，其中消息的 key 和 value 都按照 Debezium 协议进行编码。 @@ -599,7 +599,7 @@ Key 中的字段只包含主键或唯一索引列。字段解释如下： > **注意：** > -> WATERMARK 事件仅在[新 TiCDC 架构](/ticdc/ticdc-architecture.md)中受支持。在[经典 TiCDC 架构](/ticdc/ticdc-classic-architecture.md)中，WATERMARK 事件会被忽略。 +> WATERMARK 事件仅在 [TiCDC 新架构](/ticdc/ticdc-architecture.md)中受支持。在 [TiCDC 老架构](/ticdc/ticdc-classic-architecture.md)中，WATERMARK 事件会被忽略。 TiCDC 会将一个 WATERMARK 事件转换为一条 Kafka 消息，其中消息的 key 和 value 都按照 Debezium 协议进行编码。 From f46e2972f91450dde208c1cbac61eefec9d5cc77 Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Thu, 13 Aug 2026 17:28:49 +0800 Subject: [PATCH 5/7] Apply suggestions from code review --- ticdc/ticdc-debezium.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ticdc/ticdc-debezium.md b/ticdc/ticdc-debezium.md index ab900b79b9c4..0e0dc88a337c 100644 --- a/ticdc/ticdc-debezium.md +++ b/ticdc/ticdc-debezium.md @@ -14,7 +14,7 @@ summary: 了解 TiCDC Debezium Protocol 的概念和使用方法。
-要使用 TiCDC 新架构，请将 TiCDC 配置项 [`newarch`](/ticdc/ticdc-server-config.md#newarch-从-v854-版本开始引入-release1) 设置为 `true`。 +要使用 TiCDC 新架构，请将 TiCDC 配置项 [`newarch`](/ticdc/ticdc-server-config.md#newarch-从-v854-release1-版本开始引入) 设置为 `true`。 Debezium 协议支持以下类型的事件： From 8cf027a03515a2887ec926038cf28812fe6542a2 Mon Sep 17 00:00:00 2001 From: lilin90 Date: Fri, 14 Aug 2026 15:51:19 +0800 Subject: [PATCH 6/7] Update ticdc-debezium.md --- ticdc/ticdc-debezium.md | 25 ++----------------------- 1 file changed, 2 insertions(+), 23 deletions(-) diff --git a/ticdc/ticdc-debezium.md b/ticdc/ticdc-debezium.md index 0e0dc88a337c..95e1138bc350 100644 --- a/ticdc/ticdc-debezium.md +++ b/ticdc/ticdc-debezium.md @@ -11,25 +11,12 @@ summary: 了解 TiCDC Debezium Protocol 的概念和使用方法。 当使用 Kafka 作为下游 Sink 时，你可以将 `sink-uri` 的 `protocol` 字段指定为 `debezium`，TiCDC 将以 event 为基本单位封装构造 Debezium 消息，向下游发送 TiDB 的数据变更事件。 - -
- -要使用 TiCDC 新架构，请将 TiCDC 配置项 [`newarch`](/ticdc/ticdc-server-config.md#newarch-从-v854-release1-版本开始引入) 设置为 `true`。 - Debezium 协议支持以下类型的事件： - DDL 事件：表示 DDL 变更记录。在上游 DDL 语句成功执行后，DDL 事件被发送到每个 MQ (Message Queue) 分区。 - DML 事件：表示一行数据变更记录。在行变更发生时，DML 事件被发出，包含变更后该行的相关信息。 - WATERMARK 事件：表示一个特殊的时间点。在这个时间点之前收到的事件是完整的。仅适用于 TiDB 扩展字段，当你在 `sink-uri` 中设置 [`enable-tidb-extension`](/ticdc/ticdc-sink-to-kafka.md#sink-uri-配置-kafka) 为 `true` 时生效。 -
-
- -Debezium 协议仅支持 Row Changed 事件，并会直接忽略 DDL 事件和 WATERMARK 事件。Row changed 事件表示一行中的数据变更。当某一行发生变更时，会发送 Row Changed 事件，其中包含该行变更前后的相关信息。WATERMARK 事件标记表的复制进度，表示所有早于该 watermark 的事件都已发送到下游。 - -
- - 使用 Debezium 消息格式时的配置样例如下所示： ```shell @@ -44,11 +31,7 @@ Debezium 输出格式中包含当前行的 Schema 信息，以便下游消费者 本节介绍 DDL 事件、DML 事件和 WATERMARK 事件的消息格式。 -### DDL 事件（TiCDC 新架构） - -> **注意：** -> -> DDL 事件仅在 [TiCDC 新架构](/ticdc/ticdc-architecture.md)中受支持。在 [TiCDC 老架构](/ticdc/ticdc-classic-architecture.md)中，DDL 事件会被忽略。 +### DDL 事件 TiCDC 会将一个 DDL 事件转换为一条 Kafka 消息，其中消息的 key 和 value 都按照 Debezium 协议进行编码。 @@ -595,11 +578,7 @@ Key 中的字段只包含主键或唯一索引列。字段解释如下： | `schema.optional` | 布尔值 | 该字段是否为选填项。值为 `true` 表示该字段为选填项。 | | `schema.type` | 字符串 | 字段的类型。 | -### WATERMARK 事件（TiCDC 新架构） - -> **注意：** -> -> WATERMARK 事件仅在 [TiCDC 新架构](/ticdc/ticdc-architecture.md)中受支持。在 [TiCDC 老架构](/ticdc/ticdc-classic-architecture.md)中，WATERMARK 事件会被忽略。 +### WATERMARK 事件 TiCDC 会将一个 WATERMARK 事件转换为一条 Kafka 消息，其中消息的 key 和 value 都按照 Debezium 协议进行编码。 From f254d84b177df66d587b278c9d52d0300285d269 Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Fri, 14 Aug 2026 16:29:28 +0800 Subject: [PATCH 7/7] Apply suggestions from code review Co-authored-by: Grace Cai --- ticdc/ticdc-debezium.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ticdc/ticdc-debezium.md b/ticdc/ticdc-debezium.md index 95e1138bc350..cfd37a70bbab 100644 --- a/ticdc/ticdc-debezium.md +++ b/ticdc/ticdc-debezium.md @@ -5,7 +5,7 @@ summary: 了解 TiCDC Debezium Protocol 的概念和使用方法。 # TiCDC Debezium Protocol -[Debezium](https://debezium.io/) 是一个用于捕获数据库变更的工具。它会将捕获的数据库变更的每一条记录转化为一个被称为“事件” (event) 的消息 (message)，并将这些事件发送到 Kafka 中。从 v8.0.0 起，TiCDC 支持将 TiDB 的变更以 Debezium 的格式直接传输到 Kafka，为之前使用 Debezium 的 MySQL 集成的用户简化了从 MySQL 数据库迁移的过程。从 [TiCDC v8.5.4-release.1](https://github.com/pingcap/ticdc/releases/tag/v8.5.4-release.1)（[TiCDC 新架构](/ticdc/ticdc-architecture.md)）和 v9.0.0 起，TiCDC 支持 DDL 事件和 WATERMARK 事件。 +[Debezium](https://debezium.io/) 是一个用于捕获数据库变更的工具。它会将捕获的数据库变更的每一条记录转化为一个被称为“事件” (event) 的消息 (message)，并将这些事件发送到 Kafka 中。从 v8.0.0 起，TiCDC 支持将 TiDB 的行数据变更（DML 事件）以 Debezium 的格式直接传输到 Kafka，为之前使用 Debezium 的 MySQL 集成的用户简化了从 MySQL 数据库迁移的过程。从 [TiCDC v8.5.4-release.1](https://github.com/pingcap/ticdc/releases/tag/v8.5.4-release.1)（[TiCDC 新架构](/ticdc/ticdc-architecture.md)）和 v9.0.0 起，TiCDC 支持以 Debezium 的格式同步 DDL 事件和 WATERMARK 事件。 ## 使用 Debezium 消息格式