pingcap · lidezhu · Feb 10, 2025 · Feb 10, 2025 · Feb 10, 2025 · Feb 11, 2025
diff --git a/TOC.md b/TOC.md
@@ -178,9 +178,11 @@
     - [日志过滤器](/ticdc/ticdc-filter.md)
     - [DDL 同步](/ticdc/ticdc-ddl.md)
     - [双向复制](/ticdc/ticdc-bidirectional-replication.md)
+  - [TiCDC 新架构介绍](/ticdc/ticdc-new-arch.md)
   - 监控告警
     - [基本监控指标](/ticdc/ticdc-summary-monitor.md)
     - [详细监控指标](/ticdc/monitor-ticdc.md)
+    - [TiCDC 新架构监控指标](/ticdc/ticdc-new-arch-monitor.md)
     - [报警规则](/ticdc/ticdc-alert-rules.md)
   - 数据集成场景
     - [数据集成概述](/integration-overview.md)

diff --git a/media/ticdc/ticdc-new-arch-1.jpg b/media/ticdc/ticdc-new-arch-1.jpg
diff --git a/media/ticdc/ticdc-new-arch-2.jpg b/media/ticdc/ticdc-new-arch-2.jpg
diff --git a/ticdc/ticdc-new-arch-monitor.md b/ticdc/ticdc-new-arch-monitor.md
@@ -0,0 +1 @@
+TODO
diff --git a/ticdc/ticdc-new-arch.md b/ticdc/ticdc-new-arch.md
@@ -0,0 +1,134 @@
+---
+title: TiCDC 新架构介绍
+summary: 介绍 TiCDC 新架构的主要特性，架构特点，升级部署指南以及其他注意事项。
+---
+
+# TiCDC 新架构介绍
+
+## 概述
+
+TiCDC 新架构通过重新设计核心组件和优化数据处理流程，显著提升了实时数据同步的性能、扩展性和稳定性，同时降低了资源成本。新架构的主要优势包括：
+
+1. 更高的单节点性能：单节点最高支持 50 万张表的同步任务；宽表场景下最高同步流量可达 200MiB/s。
+
+2. 更强的扩展能力：集群同步能力接近线性扩展，单集群预计可扩展至 100 个节点以上，支持超 1万个 Changefeed；单个 Changefeed 可支持百万级表的同步任务。
+
+3. 更高的稳定性：在高流量、频繁 DDL 操作及集群扩缩容等场景下，Changefeed 延迟更小且更稳定；通过资源隔离和优先级调度，减少多 Changefeed 任务间的相互干扰。
+
+4. 更低的资源成本：改进资源利用率，减少冗余开销，典型场景下 CPU、内存等资源利用效率提升最多一个数量级。
+
+## 架构设计
+
+![TiCDC New Architecture](/media/ticdc/ticdc-new-arch-1.jpg)
+
+TiCDC 新架构由 Log Service 和 Downstream Adapter 两大核心组件构成。其中，Log Service 作为核心数据服务层，主要负责实时拉取上游 TiDB 集群的行变更和 DDL 变更等信息，并将其持久化存储在本地。同时，它还负责响应 Downstream Adapter 的数据请求，定时将 DML 和 DDL 数据合并排序并推送至 Downstream Adapter。Downstream Adapter 作为下游数据同步适配层，主要负责处理用户发起的 Changefeed 运维操作，调度生成相关同步任务，从 Log Service 获取数据并同步至下游系统。
+
+TiCDC 新架构通过将整体架构拆分成有状态和无状态的两部分，显著提升了系统的可扩展性、可靠性和灵活性。Log Service 作为有状态组件，专注于数据的获取、排序和存储，通过与 Changefeed 业务逻辑的解耦，实现了数据在多个 Changefeed 间的共享，有效提高了资源利用率，降低了系统开销。 Downstream Adapter 作为无状态组件，采用轻量级调度机制，支持任务在不同实例间的快速迁移，并根据负载变化灵活调整同步任务的拆分与合并，确保在各种场景下都能实现低延迟的数据同步。此外，这种架构设计为后续演进提供了更大的灵活性，Log Service 和 Downstream Adapter 可以部署在不同的进程中，使得系统能够根据负载特征进行独立扩容，避免资源浪费，进一步提升资源利用率。
+
+## 新老架构对比
+
+TiCDC 老架构采用 Timer Driven 模式来驱动系统的处理逻辑。该模式的核心机制是通过定时器触发的大循环来持续推动任务的执行。例如，每个 Changefeed 内部都会运行一个主循环，每隔 50ms 检查一次所有表，判断是否存在待处理任务，若有则将其加入处理队列供其他线程处理。这种模式的主要优势在于实现简单、逻辑清晰、可控性强，且资源使用可预测。然而，其缺点也较为明显，包括处理性能有限、难以扩展以及资源浪费等问题。以下是一些具体例子
+
+- 50ms 的间隔是平衡性能和资源浪费之间的折衷结果。目前 CDC 需要 3 个步骤才能处理完一个 DDL 操作，并且由于存在中央控制节点（Owner）需要和工作节点通讯（Worker），所以实际需要 6 个循环才能处理完。1s / (3*2*50ms) = 3.33 DDLs per second。
+
+- 该处理模型的复杂度是 O(n)，其中 n 通常等于表的数量。当表数量庞大时，处理性能会显著下降。此外，每次检查都会涉及大量无新数据处理的表，导致大量 CPU 资源被浪费在对不活跃表的检查上。
+
+- 每个 Changefeed 最多只能利用一个逻辑 CPU 来处理循环，这意味着无法通过增加 CPU 来扩展处理能力。
+
+- 中央控制节点（Owner）在一个逻辑 CPU 里处理所有的 Changefeed，造成不同 Changefeed 之间会相互干扰，限制了老架构下 Changefeed 数量的上限。
+
+相比之下，TiCDC 新架构中采用了 Event Driven 模式来驱动系统的处理逻辑。在该模式中，所有处理逻辑均由 Event（事件）驱动，这些事件包括 DML、DDL 变更以及 Changefeed 的创建、修改等。事件被放入队列后，由多个线程并发消费处理。这种模式具有以下优势：
+
+- 该模型通过事件队列和多线程消费机制，能够充分利用多核 CPU 的并行处理能力。
+
+- 消费线程只需等待并处理队列中的事件，无需浪费额外资源检查不活跃的任务。
+
+- 队列中的事件会被尽快处理，无需等待 50ms 的固定间隔，从而减少了额外的延迟。
+
+- 每个处理过程的复杂度均为 O(1)，效率更高，且不受表数量的影响。这也是新架构能够高效处理海量表的关键所在。
+
+![TiCDC New Architecture](/media/ticdc/ticdc-new-arch-2.jpg)
+
+## 使用指南
-## 使用指南
+## 新架构部署指南
-## 使用指南
+## 新架构部署指南
+
+TiCDC 新架构仅支持 v7.5 或者以上版本的 TiDB 集群，使用之前需要确保 TiDB 集群版本满足要求。
+
+### 使用 TiUP 部署启用新架构 TiCDC 的全新 TiDB 集群
+
+在使用 TiUP 部署 v9.0 或者以上版本的全新 TiDB 集群时，支持同时部署启用新架构的 TiCDC 组件。你需要在 TiUP 启动 TiDB 集群时的配置文件中加入 TiCDC 组件相关的部分并启用新架构，以下是一个示例：
+
+```shell
+cdc_servers:
+  - host: 10.0.1.20
+    config:
+      newarch: true
+  - host: 10.0.1.21
+    config:
+      newarch: true
+```
+
+NOTE: 在使用 TiCDC 老架构时，请勿在配置文件中添加 `newarch` 配置项。`newarch` 仅用于新架构，不添加 `newarch` 配置项默认使用老架构。如果在 TiCDC 老架构的配置文件中添加 newarch，可能会导致解析失败。
+
+其他详细操作，请参考[使用 TiUP 部署包含 TiCDC 组件的全新 TiDB 集群](/ticdc/deploy-ticdc.md#使用-tiup-部署包含-ticdc-组件的全新-tidb-集群)
+
+### 使用 TiUP 在原有 TiDB 集群全新部署启用新架构的 TiCDC 组件
+
+1. 参考[扩容 TiCDC 节点](/scale-tidb-using-tiup.md#扩容-ticdc-节点)在集群中扩容新的 TiCDC 节点。
+
+2. 参考下一节启用 TiCDC 新架构。
+
+### 使用 TiUP 将原有 TiDB 集群中的 TiCDC 升级为新架构
+
+如果 TiDB 集群为 v9.0 以下版本，需要手动下载 v9.0 或者以上版本的 TiCDC 二进制文件，并 Patch 到集群中。
+
+> **注意：**
+> 
+> 升级至TiCDC新架构后，将不再支持回退至旧架构。
+
+1. TiCDC 二进制文件下载链接格式为 `https://tiup-mirrors.pingcap.com/${component}-${version}-${os}-${arch}.tar.gz`，例如可以用以下命令下载 Linux 系统 x86-64 架构的 TiCDC v9.0.0 版本的二进制文件（更多信息参考[tiup cluster patch](/tiup/tiup-component-cluster-patch.md)）：
+
+```shell
+wget https://tiup-mirrors.pingcap.com/cdc-v9.0.0-linux-amd64.tar.gz
+```
+
+2. 将下载的 TiCDC 二进制文件 Patch 到集群中：
+
+```shell
+tiup cluster patch <cluster-name> ./cdc-v9.0.0-linux-amd64.tar.gz -R cdc
+```
+
+当 TiDB 集群中 TiCDC 组件版本已经升级到 v9.0 或者以上版本后，可以通过以下步骤启用 TiCDC 新架构。
+
+1. 如果集群中已经有 Changefeed，需要参考[停止同步任务](/ticdc/ticdc-manage-changefeed.md#停止同步任务) 暂停所有的 Changefeed 同步任务；
+
+2. 通过 TiUP 更新 TiCDC 配置：
+
+```shell
+tiup cluster edit-config <cluster-name>
+```
+
+```shell
+server_configs:
+  cdc:
+    newarch: true
+```
+
+3. 参考[恢复同步任务](/ticdc/ticdc-manage-changefeed.md#恢复同步任务)恢复所有的 Changefeed 同步任务；
+
-
+## 新架构命令使用指南
+
+在部署完新架构的节点之后，即可使用新架构的命令来操作新架构的 TiCDC 节点了。
+
+新架构的使用命令与老架构采用的是同一套命令逻辑，需要注意的是要在命令中加上一个标志或者设置一个环境变量来让新架构的 TiCDC 节点执行命令。下面是使用方式的具体说明：
+
+### 方式一：使用 `--newarch` 或 `-x` 标志
+
+如果想让新架构的 TiCDC 节点执行某个命令，可以在命令中添加 `--newarch`（或 `-x`）标志。例如：
+
+```
+cdc --newarch cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://root:123456@127.0.0.1:3306/" --changefeed-id="simple-replication-task"
+```
+
+或使用 `-x` 的简写形式：
+
+```
+cdc -x cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://root:123456@127.0.0.1:3306/" --changefeed-id="simple-replication-task"
+```
+
+这样便可在新架构的 TiCDC 节点中创建 Changefeed。
+
+如果不加 `--newarch` 或 `-x` 标志，将默认让老架构的 TiCDC 节点执行命令：
+
+```
+# 默认使用老架构
+cdc cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://root:123456@127.0.0.1:3306/" --changefeed-id="simple-replication-task"
+```
+
+这样依旧是在老架构的 TiCDC 节点中创建 Changefeed。
+
+### 方式二：使用 `TICDC_NEWARCH` 环境变量
+
+若需要经常手动执行命令操作 TiCDC 新架构，可设置环境变量 `TICDC_NEWARCH=true`，这样当前终端会话中的所有 TiCDC 命令都会采用新架构。例如：
+
+```
+export TICDC_NEWARCH=true # 在当前终端会话中，之后所有的 TiCDC 命令都会采用新架构
+
+# 现在默认使用的是新架构，在新架构 TiCDC 节点中创建 Changefeed
+cdc cli changefeed create cdc cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://root:123456@127.0.0.1:3306/" --changefeed-id="simple-replication-task" 
+```
+
+如果需要切换回老架构，可以取消该环境变量：
+
+```
+unset TICDC_NEWARCH
+
+# 重新默认使用老架构，在老架构 TiCDC 节点中创建 Changefeed
+cdc cli changefeed create cdc cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://root:123456@127.0.0.1:3306/" --changefeed-id="simple-replication-task"
+```
+
+### 常见命令示例
+
+以下是一些 TiCDC 相关命令在新架构下的常见使用示例。
+
+1. **在新架构的 TiCDC 节点中创建 Changefeed**
+
+* 添加 `--newarch` 或 `-x` 标志：
+
+    ```
+    cdc -x cli changefeed create cdc cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://root:123456@127.0.0.1:3306/" --changefeed-id="simple-replication-task" 
+    ```
+
+* 设置 `TICDC_NEWARCH` 环境变量，后续该终端会话下的所有 TiCDC 命令都无需额外设置即可使用新架构：
+
+    ```
+    export TICDC_NEWARCH=true
+    cdc cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://root:123456@127.0.0.1:3306/" --changefeed-id="simple-replication-task"
+    ```
+
+2. **查看 Changefeed 列表**
+
+  * 添加 `--newarch` 或 `-x` 标志：
+
+    ```
+    cdc -x cli changefeed list --server=http://10.0.10.25:8300
+    ```
+
+* 设置 `TICDC_NEWARCH` 环境变量，后续该终端会话下的所有 TiCDC 命令都无需额外设置即可使用新架构：
+
+    ```
+    export TICDC_NEWARCH=true
+    cdc cli changefeed list --server=http://10.0.10.25:8300
+    ```
+
+
+3. **暂停 Changefeed**
+
+* 添加 `--newarch` 或 `-x` 标志：
+
+    ```
+    cdc -x cli changefeed pause --server=http://10.0.10.25:8300 --changefeed-id simple-replication-task
+    ```
+
+* 设置 `TICDC_NEWARCH` 环境变量，后续该终端会话下的所有 TiCDC 命令都无需额外设置即可使用新架构：
+
+    ```
+    export TICDC_NEWARCH=true
+    cdc cli changefeed pause --server=http://10.0.10.25:8300 --changefeed-id simple-replication-task
+    ```
+
+4. **恢复 Changefeed**
+
+* 添加 `--newarch` 或 `-x` 标志：
+
+    ```
+    cdc -x cli changefeed resume --server=http://10.0.10.25:8300 --changefeed-id simple-replication-task
+    ```
+
+* 设置 `TICDC_NEWARCH` 环境变量，后续该终端会话下的所有 TiCDC 命令都无需额外设置即可使用新架构：
+
+    ```
+    export TICDC_NEWARCH=true
+    cdc cli changefeed resume --server=http://10.0.10.25:8300 --changefeed-id simple-replication-task
+    ```
+
+5. **删除 Changefeed**
+
+* 添加 `--newarch` 或 `-x` 标志：
+
+    ```
+    cdc -x cli changefeed remove --server=http://10.0.10.25:8300 --changefeed-id simple-replication-task
+    ```
+
+* 设置 `TICDC_NEWARCH` 环境变量，后续该终端会话下的所有 TiCDC 命令都无需额外设置即可使用新架构：
+
+    ```
+    export TICDC_NEWARCH=true
+    cdc cli changefeed remove --server=http://10.0.10.25:8300 --changefeed-id simple-replication-task
+    ```
+
+6. **查询特定 Changefeed 信息**
+
+* 添加 `--newarch` 或 `-x` 标志：
+
+    ```
+    cdc -x cli changefeed query -s --server=http://10.0.10.25:8300 --changefeed-id=simple-replication-task
+    ```
+
+* 设置 `TICDC_NEWARCH` 环境变量，后续该终端会话下的所有 TiCDC 命令都无需额外设置即可使用新架构：
+
+    ```
+    export TICDC_NEWARCH=true
+    cdc cli changefeed query -s --server=http://10.0.10.25:8300 --changefeed-id=simple-replication-task
+    ```
+
+7. **查看可用命令**
+
+    由于新架构仍在逐步完善，部分命令可能尚未支持。可以使用以下命令查看当前架构下的可用命令：
+
+* 查看新架构当前支持的命令：
+
+    ```
+    cdc --newarch help # 或者使用 -x
+    ```
+
+* 对比查看老架构当前支持的命令：
+
+    ```
+    cdc help
+    ```
+
+    在未来版本中，我们将逐步增加对 TiCDC 新架构更多命令的支持，请关注后续版本更新，以获取最新功能支持。
-
+## 新架构命令使用指南
+
+在部署完新架构的节点之后，即可使用新架构的命令来操作新架构的 TiCDC 节点了。
+
+新架构的使用命令与老架构采用的是同一套命令逻辑，需要注意的是要在命令中加上一个标志或者设置一个环境变量来让新架构的 TiCDC 节点执行命令。下面是使用方式的具体说明：
+
+### 方式一：使用 `--newarch` 或 `-x` 标志
+
+如果想让新架构的 TiCDC 节点执行某个命令，可以在命令中添加 `--newarch`（或 `-x`）标志。例如：
+
+```
+cdc --newarch cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://root:123456@127.0.0.1:3306/" --changefeed-id="simple-replication-task"
+```
+
+或使用 `-x` 的简写形式：
+
+```
+cdc -x cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://root:123456@127.0.0.1:3306/" --changefeed-id="simple-replication-task"
+```
+
+这样便可在新架构的 TiCDC 节点中创建 Changefeed。
+
+如果不加 `--newarch` 或 `-x` 标志，将默认让老架构的 TiCDC 节点执行命令：
+
+```
+# 默认使用老架构
+cdc cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://root:123456@127.0.0.1:3306/" --changefeed-id="simple-replication-task"
+```
+
+这样依旧是在老架构的 TiCDC 节点中创建 Changefeed。
+
+### 方式二：使用 `TICDC_NEWARCH` 环境变量
+
+若需要经常手动执行命令操作 TiCDC 新架构，可设置环境变量 `TICDC_NEWARCH=true`，这样当前终端会话中的所有 TiCDC 命令都会采用新架构。例如：
+
+```
+export TICDC_NEWARCH=true # 在当前终端会话中，之后所有的 TiCDC 命令都会采用新架构
+
+# 现在默认使用的是新架构，在新架构 TiCDC 节点中创建 Changefeed
+cdc cli changefeed create cdc cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://root:123456@127.0.0.1:3306/" --changefeed-id="simple-replication-task" 
+```
+
+如果需要切换回老架构，可以取消该环境变量：
+
+```
+unset TICDC_NEWARCH
+
+# 重新默认使用老架构，在老架构 TiCDC 节点中创建 Changefeed
+cdc cli changefeed create cdc cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://root:123456@127.0.0.1:3306/" --changefeed-id="simple-replication-task"
+```
+
+### 常见命令示例
+
+以下是一些 TiCDC 相关命令在新架构下的常见使用示例。
+
+1. **在新架构的 TiCDC 节点中创建 Changefeed**
+
+* 添加 `--newarch` 或 `-x` 标志：
+
+    ```
+    cdc -x cli changefeed create cdc cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://root:123456@127.0.0.1:3306/" --changefeed-id="simple-replication-task" 
+    ```
+
+* 设置 `TICDC_NEWARCH` 环境变量，后续该终端会话下的所有 TiCDC 命令都无需额外设置即可使用新架构：
+
+    ```
+    export TICDC_NEWARCH=true
+    cdc cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://root:123456@127.0.0.1:3306/" --changefeed-id="simple-replication-task"
+    ```
+
+2. **查看 Changefeed 列表**
+
+  * 添加 `--newarch` 或 `-x` 标志：
+
+    ```
+    cdc -x cli changefeed list --server=http://10.0.10.25:8300
+    ```
+
+* 设置 `TICDC_NEWARCH` 环境变量，后续该终端会话下的所有 TiCDC 命令都无需额外设置即可使用新架构：
+
+    ```
+    export TICDC_NEWARCH=true
+    cdc cli changefeed list --server=http://10.0.10.25:8300
+    ```
+
+
+3. **暂停 Changefeed**
+
+* 添加 `--newarch` 或 `-x` 标志：
+
+    ```
+    cdc -x cli changefeed pause --server=http://10.0.10.25:8300 --changefeed-id simple-replication-task
+    ```
+
+* 设置 `TICDC_NEWARCH` 环境变量，后续该终端会话下的所有 TiCDC 命令都无需额外设置即可使用新架构：
+
+    ```
+    export TICDC_NEWARCH=true
+    cdc cli changefeed pause --server=http://10.0.10.25:8300 --changefeed-id simple-replication-task
+    ```
+
+4. **恢复 Changefeed**
+
+* 添加 `--newarch` 或 `-x` 标志：
+
+    ```
+    cdc -x cli changefeed resume --server=http://10.0.10.25:8300 --changefeed-id simple-replication-task
+    ```
+
+* 设置 `TICDC_NEWARCH` 环境变量，后续该终端会话下的所有 TiCDC 命令都无需额外设置即可使用新架构：
+
+    ```
+    export TICDC_NEWARCH=true
+    cdc cli changefeed resume --server=http://10.0.10.25:8300 --changefeed-id simple-replication-task
+    ```
+
+5. **删除 Changefeed**
+
+* 添加 `--newarch` 或 `-x` 标志：
+
+    ```
+    cdc -x cli changefeed remove --server=http://10.0.10.25:8300 --changefeed-id simple-replication-task
+    ```
+
+* 设置 `TICDC_NEWARCH` 环境变量，后续该终端会话下的所有 TiCDC 命令都无需额外设置即可使用新架构：
+
+    ```
+    export TICDC_NEWARCH=true
+    cdc cli changefeed remove --server=http://10.0.10.25:8300 --changefeed-id simple-replication-task
+    ```
+
+6. **查询特定 Changefeed 信息**
+
+* 添加 `--newarch` 或 `-x` 标志：
+
+    ```
+    cdc -x cli changefeed query -s --server=http://10.0.10.25:8300 --changefeed-id=simple-replication-task
+    ```
+
+* 设置 `TICDC_NEWARCH` 环境变量，后续该终端会话下的所有 TiCDC 命令都无需额外设置即可使用新架构：
+
+    ```
+    export TICDC_NEWARCH=true
+    cdc cli changefeed query -s --server=http://10.0.10.25:8300 --changefeed-id=simple-replication-task
+    ```
+
+7. **查看可用命令**
+
+    由于新架构仍在逐步完善，部分命令可能尚未支持。可以使用以下命令查看当前架构下的可用命令：
+
+* 查看新架构当前支持的命令：
+
+    ```
+    cdc --newarch help # 或者使用 -x
+    ```
+
+* 对比查看老架构当前支持的命令：
+
+    ```
+    cdc help
+    ```
+
+    在未来版本中，我们将逐步增加对 TiCDC 新架构更多命令的支持，请关注后续版本更新，以获取最新功能支持。
+## 注意事项
+
+1. TiCDC 老架构中，DDL 同步采用完全串行的方式，因此 DDL 的同步进度仅需用 Changefeed 的 `CheckpointTs` 标识即可。但是在新架构中为了提高 DDL 同步效率，会尽可能并行同步不同表的 DDL，为了在下游为 MySQL 兼容数据库时准确记录各表的 DDL 同步进度，TiCDC 需要额外在下游数据库中创建一张名为 `tidb_cdc.ddl_ts_v1` 的表，专门用于存储 Changefeed 的 DDL 同步进度信息。
+
+2. 作为实验性特性，TiCDC v9.0 的新架构尚未完全实现旧架构中的所有功能，这些功能将在后续的 GA 版本中完整实现，具体包括：
+    - [拆分 Update 事件](/ticdc/ticdc-split-update-behavior.md)
+    - [灾难场景的最终一致性复制](/ticdc/ticdc-sink-to-mysql.md#灾难场景的最终一致性复制)
+    - 拆分大事务
+    - [TiCDC Avro Protocol](/ticdc/ticdc-avro-protocol.md)
+    - [TiCDC CSV Protocol](/ticdc/ticdc-csv.md)
+    - [TiCDC Debezium Protocol](/ticdc/ticdc-debezium.md)
+    - [TiCDC Simple Protocol](/ticdc/ticdc-simple-protocol.md)
+    - [Event Filter 事件过滤器](/ticdc/ticdc-filter.md#event-filter-事件过滤器-从-v620-版本开始引入)
+    - [TiCDC 单行数据正确性校验](/ticdc/ticdc-integrity-check.md)
+    - [TiCDC 双向复制](/ticdc/ticdc-bidirectional-replication.md)
+    - [同步数据到 Pulsar](/ticdc/ticdc-sink-to-pulsar.md)
+    - [同步数据到存储服务](/ticdc/ticdc-sink-to-cloud-storage.md)
diff --git a/ticdc/ticdc-server-config.md b/ticdc/ticdc-server-config.md
@@ -30,6 +30,12 @@ summary: 了解 TiCDC 详细的命令行参数和配置文件定义。
 
 对于 `cdc server` 命令中 `config` 参数指定的配置文件说明如下。你可以在 [`pkg/cmd/util/ticdc.toml`](https://github.com/pingcap/tiflow/blob/master/pkg/cmd/util/ticdc.toml) 找到默认值的配置文件。
 
+### `newarch`
+
+- v9.0 版本引入，控制是否开启 TiCDC 新架构
+- 当设置为 `true`，表示开启 TiCDC 新架构
+- 默认值为不设置，表示使用老架构。`newarch` 仅用于新架构，如果在 TiCDC 老架构的配置文件中添加 newarch，可能会导致解析失败。
+
 <!-- 下面的字段的配置含义与命令行参数相同，但是命令行参数优先级更高 -->
 
 ### `addr`