Postgres ClickPipe 的生命周期

各种管道状态及其含义

本文档介绍 Postgres ClickPipe 的各个阶段、可能出现的不同状态及其含义。

​

预配

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

​

设置

管道预配完成后，会进入 Setup 状态。在此状态下，我们会创建目标端 ClickHouse 表，并获取并记录源表的表定义。

​

快照

设置完成后，我们会进入 Snapshot 状态 (除非这是仅支持 CDC (变更数据捕获) 的管道，此时会切换到 Running) 。Snapshot、Initial Snapshot 和 Initial Load (更常用) 这几个术语可以互换使用。在此状态下，我们会对源数据库中的表创建快照，并将其加载到 ClickHouse 中。此过程不使用逻辑复制，但会在这一步创建 replication slot，因此你的 max_slot_wal_keep_size 和存储参数应将初始加载期间 slot 的增长考虑在内。有关初始加载的更多信息，请参阅并行初始加载文档。当触发重新同步，或向现有管道添加新表时，管道也会进入 Snapshot 状态。

​

运行中

初始加载完成后，管道会进入 Running 状态 (除非它是仅快照管道，此时会切换为 Completed) 。此时，管道会开始执行 Change-Data Capture。在该状态下，我们会启动从源数据库到 ClickHouse 的逻辑复制。有关如何控制 CDC (变更数据捕获) ，请参阅控制 CDC 的文档。

​

已暂停

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

​

暂停

该状态即将推出。如果您正在使用我们的 OpenAPI，建议现在就添加对该状态的支持，以确保发布后您的集成仍能正常工作。

当您点击 Pause 按钮时，管道会进入 Pausing 状态。这是一个过渡状态，表示系统正在停止 CDC (变更数据捕获) 进程。当 CDC (变更数据捕获) 进程完全停止后，管道将进入 Paused 状态。

​

修改中

此状态即将上线。如果您正在使用我们的 OpenAPI，建议现在就添加对该状态的支持，以确保发布后您的集成仍能继续正常工作。

目前，这表示该管道正在移除表。

​

重新同步

此状态即将上线。如果你正在使用我们的 OpenAPI，建议现在就为其添加支持，以确保该状态发布后，你的集成仍能继续正常工作。

此状态表示该管道正处于重新同步阶段，此时会将 _resync 表与原始表进行原子交换。有关重新同步的更多信息，请参阅重新同步文档。

​

已完成

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

​

失败

如果管道中出现不可恢复的错误，它将进入 Failed 状态。你可以联系支持团队，或对管道执行重新同步，以使其从该状态恢复。