> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 各种管道状态及其含义

# Postgres ClickPipe 的生命周期

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

<div id="provisioning">
  ## 预配
</div>

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

<div id="setup">
  ## 设置
</div>

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

<div id="snapshot">
  ## 快照
</div>

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

<div id="running">
  ## 运行中
</div>

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

<div id="paused">
  ## 已暂停
</div>

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

<div id="pausing">
  ## 暂停
</div>

<Note>
  该状态即将推出。如果您正在使用我们的 [OpenAPI](/zh/products/cloud/features/admin-features/api/openapi)，建议现在就添加对该状态的支持，以确保发布后您的集成仍能正常工作。
</Note>

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

<div id="modifying">
  ## 修改中
</div>

<Note>
  此状态即将上线。如果您正在使用我们的 [OpenAPI](/zh/products/cloud/features/admin-features/api/openapi)，建议现在就添加对该状态的支持，以确保发布后您的集成仍能继续正常工作。
</Note>

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

<div id="resync">
  ## 重新同步
</div>

<Note>
  此状态即将上线。如果你正在使用我们的 [OpenAPI](/zh/products/cloud/features/admin-features/api/openapi)，建议现在就为其添加支持，以确保该状态发布后，你的集成仍能继续正常工作。
</Note>

此状态表示该管道正处于重新同步阶段，此时会将 `_resync` 表与原始表进行原子交换。有关重新同步的更多信息，请参阅[重新同步文档](/zh/integrations/clickpipes/postgres/resync)。

<div id="completed">
  ## 已完成
</div>

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

<div id="failed">
  ## 失败
</div>

如果管道中出现不可恢复的错误，它将进入 `Failed` 状态。你可以联系支持团队，或对管道执行[重新同步](/zh/integrations/clickpipes/postgres/resync)，以使其从该状态恢复。