infra-postgres

使用 clickhousectl 管理 Postgres

clickhousectl 可在两种环境中管理 Postgres：

• 本地 — 在用户的计算机上运行由 Docker 支持的命名 Postgres 实例，用于开发。
• 云端 — ClickHouse Cloud 中托管的 Postgres 服务（测试版），用于生产环境：高可用性、只读副本、时间点恢复。

本文会引导你找到合适的参考文档。分步工作流位于 ref/local.md、ref/cloud.md 和 ref/migrate.md 中；运行命令前，请先阅读与用户情况相符的文档。

应该参考哪篇文档

用户想要……	阅读
在本地开发或构建原型、针对 Postgres 运行测试/CI，无需云账号	ref/local.md
部署到生产环境、托管 Postgres 服务，或明确使用 ClickHouse Cloud	ref/cloud.md
运维现有云服务（密码、TLS、配置、副本、故障转移、恢复）	ref/cloud.md
将现有 Postgres（Neon、Supabase、RDS 等）迁移到 ClickHouse Cloud Postgres	ref/migrate.md
现在在本地开发，之后再部署到生产环境	从 ref/local.md 开始；准备部署到生产环境时，文中会指向 ref/cloud.md

如果确实无法确定（例如“为我的应用设置 Postgres”），开发任务默认使用本地环境；在云端创建任何内容前请先询问，因为云服务需要付费。

前置条件（适用于两种工作流）

检查是否已安装 clickhousectl：

which clickhousectl

如果未找到，请安装：

curl -fsSL https://clickhouse.com/cli | sh

安装程序会将其安装到 ~/.local/bin/clickhousectl（并创建 chctl 别名）。如果仍然找不到该命令，请建议运行 export PATH="$HOME/.local/bin:$PATH"，或打开一个新终端。

所有命令均支持 --json，可输出机器可读的结果。退出代码遵循 gh 约定：0 表示成功，1 表示错误，2 表示已取消，4 表示需要身份验证。

相关内容

• 如需将 Postgres 数据复制到 ClickHouse 以进行分析，请参阅 ClickPipes（clickhousectl cloud clickpipe --help）。ClickPipes 无法将 Postgres 服务用作目标；如需在 Postgres 之间迁移，请使用 ref/migrate.md。
• 如需使用 ClickHouse 本身（用于本地开发或 ClickHouse Cloud 服务），请使用 infra-clickhouse skill。