用途:通过 clickhousectl CLI 设置和管理 Postgres,覆盖本地开发与云端生产两类环境。本地为基于 Docker 的命名 Postgres 实例,适合开发、测试与 CI,无需云账号;云端为 ClickHouse Cloud 中的托管 Postgres 服务(beta),面向生产,提供高可用、只读副本和时间点恢复。
主要能力:本地实例的创建与运行;云端托管服务的创建与运维,包括密码、TLS、配置、副本、故障转移与恢复;以及将现有 Postgres(如 Neon、Supabase、RDS 等)迁移到 ClickHouse Cloud Postgres。
使用方式:先确认已安装 clickhousectl,执行 which clickhousectl;若未找到,安装命令为 curl -fsSL https://clickhouse.com/cli | sh,安装到 ~/.local/bin/clickhousectl(含 chctl 别名),必要时设置 export PATH="$HOME/.local/bin:$PATH" 或重开终端。具体分步流程位于 ref/local.md、ref/cloud.md、ref/migrate.md,需按场景先阅读对应文件再执行命令:本地开发或 CI 读 ref/local.md;上生产或使用 ClickHouse Cloud 读 ref/cloud.md;运维已有云服务读 ref/cloud.md;从其他 Postgres 迁移读 ref/migrate.md。先本地后上生产时,从 ref/local.md 开始,它会指向 ref/cloud.md。所有命令支持 --json 输出;退出码遵循 gh 约定:0 成功、1 错误、2 取消、4 需认证。
适用场景与限制:适合本地开发、测试、CI 及云端托管 Postgres 的创建与运维、迁移。若场景不明确(如“为我的应用设置 Postgres”),默认按本地开发处理,创建云资源前应先询问,因为云服务会产生费用。若需将 Postgres 数据复制到 ClickHouse 做分析,参见 ClickPipes(clickhousectl cloud clickpipe --help),但 ClickPipes 不能以 Postgres 服务为目标,Postgres 到 Postgres 的迁移应使用 ref/migrate.md。管理 ClickHouse 本身请使用 infra-clickhouse 技能。其他细节暂未提供。