跳转到主要内容
本文介绍 MongoDB ClickPipe 的各个阶段、可能出现的不同状态及其含义。

预配

当你点击 Create ClickPipe 按钮时,ClickPipe 会进入 Provisioning 状态。预配过程指的是启动用于为该服务运行 ClickPipes 的底层基础设施,并为该管道注册一些初始元数据。由于同一服务内的 ClickPipes 共享计算资源,因此你的第二个 ClickPipe 会比第一个创建得快得多——因为基础设施已经就位。

设置

管道创建完成后,会进入 Setup 状态。在此状态下,我们将创建目标端的 ClickHouse 表。

快照

完成设置后,我们会进入 Snapshot 状态 (除非这是仅 CDC (变更数据捕获) 的管道,此时会切换到 Running) 。SnapshotInitial SnapshotInitial Load (更常用) 这几个术语可以互换使用。在此状态下,我们会对源 MongoDB 集合创建快照,并将其加载到 ClickHouse。oplog 的保留期设置应将初始加载所需时间考虑在内。触发重新同步时,或向现有管道添加新表时,管道也会进入 Snapshot 状态。

运行中

初始加载完成后,管道会进入 Running 状态 (除非它是仅快照管道,此时会转为 Completed) 。这时,管道会开始执行 CDC (变更数据捕获) 。在此状态下,系统会开始将源 MongoDB 集群中的变更持续流式传输到 ClickHouse。有关如何控制 CDC (变更数据捕获) ,请参阅控制 CDC 的文档

已暂停

当管道处于 Running 状态时,您可以将其暂停。这会停止 CDC (变更数据捕获) 过程,管道也会进入 Paused 状态。在此状态下,不会再从源 MongoDB 拉取新数据,但 ClickHouse 中已有的数据会保持不变。您可以在此状态下恢复管道运行。

暂停

此状态即将推出。如果您正在使用我们的 OpenAPI,建议现在就添加对该状态的支持,以确保您的集成在其发布后仍能继续正常运行。
当您点击暂停按钮时,管道会进入 Pausing 状态。这是一个过渡状态,表示系统正在停止 CDC (变更数据捕获) 进程。一旦 CDC (变更数据捕获) 进程完全停止,管道将进入 Paused 状态。

修改中

该状态即将推出。如果您正在使用我们的 OpenAPI,建议现在就为其添加支持,以确保发布后您的集成仍能正常工作。
目前,这表示该管道正在移除表。

重新同步

此状态即将推出。如果您正在使用我们的 OpenAPI,建议现在就添加对该状态的支持,以确保发布后您的集成仍能继续正常工作。
此状态表示该管道正处于重新同步阶段,此时会将 _resync 表与原始表进行原子交换。有关重新同步的更多信息,请参阅重新同步文档

已完成

此状态适用于仅支持快照的管道,表示快照已完成,无需再执行其他操作。

失败

如果管道中出现不可恢复的错误,它将进入 Failed 状态。你可以联系支持团队,或重新同步管道,以从该状态恢复。
最后修改于 2026年6月10日