- 文档首页
云数据库 TiDB 版
用户指南
数据管理
同步数据
管理变更数据流
管理变更数据流
变更数据流(changefeed)帮助您将数据从云数据库 TiDB 版流式传输到其他下游系统。目前,云数据库 TiDB 版支持将数据流式传输到 RDS for MySQL。
本文介绍管理变更数据流的全生命周期。
- 云数据库 TiDB 版每个 Essential 集群最多只允许创建 10 个 变更数据流。
- 变更数据流不支持在单个 RENAME TABLE 语句中重命名多个表的 DDL 语句,例如 RENAME TABLE t1 TO t3, t2 TO t4。执行该语句会永久中断变更数据流的数据同步。
- 变更数据流的吞吐约为 20 MiB/s。若您业务在单位时间内的增量数据速率超出该限制,请联系云数据库 TiDB 版技术支持寻求协助。
要访问变更数据流页面,请按照以下步骤操作:
- 在集群列表页面,单击目标集群名称进入其概览页面。
- 在左侧导航栏单击数据 > 变更数据流,即可进入变更数据流页面。
- 在集群列表页面,单击目标集群名称进入其概览页面。
- 根据目标同步类型,参考以下文档创建变更数据流任务:
- 在集群列表页面,单击目标集群名称进入其概览页面。
- 单击目标变更数据流操作列的 ... > 查看,即可进入变更数据流详情页面。在该页面,可查看以下详细信息:
- 在属性区域,可查看变更数据流的名称、ID、状态、目标(类型)、创建时间、Checkpoints 时间、Checkpoint TSO、连接方式、MySQL 端点、MySQL 用户名、Private Link 连接 ID、端口、表过滤(规则)、起始位置信息。
- 在集群列表页面,单击目标集群名称进入其概览页面。
- 在集群列表页面,单击目标集群名称进入其概览页面。
- 单击目标变更数据流操作列的 ... > 恢复,完成恢复操作。
说明
云数据库 TiDB 版目前仅允许变更数据流处于暂停状态时进行编辑。如需编辑变更数据流,请先执行暂停操作。 - 在集群列表页面,单击目标集群名称进入其概览页面。
- 当变更数据流状态变为 Paused 后,单击 ... > 编辑,以编辑对应变更数据流。
- 云数据库 TiDB 版默认填充变更数据流配置。您可以修改以下配置:
- 同步到 MySQL:除目标和起始位置外的所有配置。
- 修改配置后,单击 ... > 恢复,以恢复对应的变更数据流。
- 在集群列表页面,单击目标集群名称进入其概览页面。
- 云数据库 TiDB 版会自动用原有设置填充新变更数据流的配置。您可以根据需要检查并修改配置。
- 确认配置后,单击提交,创建并启动新的变更数据流。
- 在集群列表页面,单击目标集群名称进入其概览页面。
在运行过程中,变更数据流可能因错误而失败,或被手动暂停或恢复。这些操作会导致变更数据流状态发生变化。
各状态说明如下:
- CREATE_FAILED:变更数据流创建失败。您需要删除该变更数据流并重新创建。
- RUNNING:变更数据流正常运行,checkpoint-ts 正常推进。
- WARNING:变更数据流返回警告。由于某些可恢复错误,变更数据流无法继续。处于该状态的变更数据流会持续尝试恢复,直到状态变为 RUNNING。该状态下的变更数据流会阻塞 GC 操作。
- RUNNING_FAILED:变更数据流运行失败。由于某些错误,变更数据流无法恢复且无法自动修复。如果在增量数据的垃圾回收(GC)之前解决了问题,您可以手动恢复失败的变更数据流。增量数据的默认生存时间(TTL)为 24 小时,即变更数据流中断后 24 小时内 GC 机制不会删除任何数据。
最近更新时间:2026.11.04 17:13:17