数据库
需要为应用搭建或管理 Postgres(本地 Docker…
适用于用户想要 Postgres/PostgreSQL、本地开发环境、psql 访问、ClickHouse Cloud 托管生产 Postgres,或从本地迁移到生产时,按 clickhousectl 的本地/云端参考流程操作。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
需要为应用搭建或管理 Postgres(特定
解决思路
- 明确 clickhousectl 管理 Postgres 的两类环境:Local 是本机命名、Docker-backed 的 Postgres 实例,用于开发;Cloud 是 ClickHouse Cloud 中托管 Postgres 服务(beta),用于生产,支持 HA、read replicas、point-in-time restore。
- 在执行命令前先根据用户目标阅读匹配的参考文档:本地流程读 ref/local.md,云端流程读 ref/cloud.md;不要跳过对应 reference 直接运行命令。
- 当用户要本地开发或原型、对 Postgres 跑测试/CI、且无需云账号时,阅读 ref/local.md 并按其步骤执行。
- 当用户要上生产、托管 managed Postgres、或明确使用 ClickHouse Cloud 时,阅读 ref/cloud.md 并按其步骤执行。
- 当用户要操作已有云服务(密码、TLS、运行时配置、read replicas、failover、point-in-time restore)时,阅读 ref/cloud.md 并按其步骤执行。
- 当用户要现在本地开发、之后再发布到生产时,先阅读 ref/local.md 并按本地流程执行;它会指向 ref/cloud.md,等要上生产时再切换到云端流程。
- 如果场景确实不明确(例如「为我的应用设置 Postgres」),默认按开发任务走本地流程;在云中创建任何东西前先询问用户,因为云服务会产生费用。
- 检查 clickhousectl 是否安装:运行 which clickhousectl。
- 如果未找到 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。
- 如果需要 ClickHouse 本身(本地开发或 ClickHouse Cloud 服务),使用 infra-clickhouse 技能。
适用边界 · 注意事项
- 用户不想使用 ClickHouse 生态、clickhousectl CLI 或 ClickHouse Cloud 时不适用;尤其不要为无云账号或不愿付费的场景创建云 Postgres。
- 只需要 ClickHouse 本身(本地或 Cloud)而不是 Postgres 时不适用,应改用 infra-clickhouse 技能。
- 目标是把 Postgres 数据复制到 ClickHouse 做分析时,不应只依赖本技能,应改用或查看 ClickPipes。