Changefeed

TiDB Cloud changefeed 帮助你将数据从 TiDB Cloud 流式传输到其他数据服务。目前，TiDB Cloud 支持将数据流式传输到 Apache Kafka、MySQL、TiDB Cloud 以及云存储。

查看 Changefeed 页面

要访问 changefeed 功能，请按照以下步骤操作：

1. 在 TiDB Cloud 控制台，进入你的项目的 Clusters 页面。

   提示：

   你可以使用左上角的下拉框在组织、项目和集群之间切换。

2. 点击目标集群的名称，进入其概览页面，然后在左侧导航栏点击 Data > Changefeed。此时会显示 changefeed 页面。

在 Changefeed 页面，你可以创建 changefeed，查看已有 changefeed 列表，并对已有 changefeed 进行操作（如扩展、暂停、恢复、edit 和删除 changefeed）。

创建 changefeed

要创建 changefeed，请参考以下教程：

• 同步到 Apache Kafka
• 同步到 MySQL
• 同步到 TiDB Cloud
• 同步到云存储

查询 changefeed 容量

对于 TiDB Cloud Dedicated，你可以查询 changefeed 的 TiCDC Replication Capacity Units（RCU）。

1. 进入目标 TiDB 集群的 Changefeed 页面。
2. 找到你要查询的 changefeed，在 Action 列点击 ... > View。
3. 你可以在页面的 Specification 区域看到当前的 TiCDC Replication Capacity Units（RCU）。

扩展 changefeed

你可以通过扩展或缩减 changefeed 来更改其 TiCDC Replication Capacity Units（RCU）。

1. 进入目标 TiDB 集群的 Changefeed 页面。
2. 找到你要扩展的 changefeed，在 Action 列点击 ... > Scale Up/Down。
3. 选择新的规格。
4. 点击 Submit。

扩展过程大约需要 10 分钟（期间 changefeed 正常工作），切换到新规格大约需要几秒（切换期间 changefeed 会自动暂停并恢复）。

暂停或恢复 changefeed

1. 进入目标 TiDB 集群的 Changefeed 页面。
2. 找到你要暂停或恢复的 changefeed，在 Action 列点击 ... > Pause/Resume。

edit changefeed

1. 进入目标 TiDB 集群的 Changefeed 页面。

2. 找到你要暂停的 changefeed，在 Action 列点击 ... > Pause。

3. 当 changefeed 状态变为 Paused 后，点击 ... > Edit 以 edit 对应的 changefeed。

   TiDB Cloud 会默认 populate changefeed 配置。你可以 edit 以下配置项：

   • Apache Kafka sink：所有配置项。
   • MySQL sink：MySQL Connection、Table Filter 和 Event Filter。
   • TiDB Cloud sink：TiDB Cloud Connection、Table Filter 和 Event Filter。
   • 云存储 sink：Storage Endpoint、Table Filter 和 Event Filter。

4. edit 配置后，点击 ... > Resume 以恢复对应的 changefeed。

复制 changefeed

1. 进入目标 TiDB 集群的 Changefeed 页面。
2. 找到你要复制的 changefeed，在 Action 列点击 ... > Duplicate。
3. TiDB Cloud 会自动 populate 新 changefeed 的配置为原有设置。你可以根据需要 review 并 edit 配置。
4. 确认配置后，点击 Submit 创建并启动新的 changefeed。

删除 changefeed

1. 进入目标 TiDB 集群的 Changefeed 页面。
2. 找到你要删除的 changefeed，在 Action 列点击 ... > Delete。

changefeed 计费

要了解 TiDB Cloud 中 changefeed 的计费方式，请参见 Changefeed 计费。

changefeed 状态

复制任务的状态表示复制任务的运行状态。在运行过程中，复制任务可能因错误而失败，或被手动暂停或恢复。这些行为会导致复制任务状态的变化。

各状态说明如下：

• CREATING：复制任务正在创建中。
• RUNNING：复制任务正常运行，checkpoint-ts 正常推进。
• EDITING：复制任务正在 edit。
• PAUSING：复制任务正在暂停中。
• PAUSED：复制任务已暂停。
• RESUMING：复制任务正在恢复中。
• DELETING：复制任务正在删除中。
• DELETED：复制任务已删除。
• WARNING：复制任务返回 warning。由于某些可恢复错误，复制无法继续。处于该状态的 changefeed 会持续尝试恢复，直到状态转为 RUNNING。该状态下的 changefeed 会阻塞 GC 操作。
• FAILED：复制任务失败。由于某些错误，复制任务无法恢复且无法自动修复。如果在增量数据的垃圾回收（GC）前解决了问题，你可以手动恢复失败的 changefeed。增量数据的默认生存时间（TTL）为 24 小时，即 changefeed 中断后 24 小时内 GC 机制不会删除任何数据。