SuperAPI AI 工具集

infra-clickhouse

编程与开发

查看项目

更新于 10-15 19:49

技能介绍

用途:使用 clickhousectl CLI 在本地或云端搭建和管理 ClickHouse。本地模式在用户机器上安装并运行 ClickHouse,适合开发;云端模式管理 ClickHouse Cloud 托管服务,适合生产,具备自动扩缩容、备份和升级能力。

主要能力:区分本地与云端两套工作流,分别对应 ref/local.md 和 ref/cloud.md 参考文档;执行前需先阅读与用户场景匹配的参考文件。本地开发无需云账号;生产托管或操作已有云服务(schema、用户、查询)走云端参考。若场景不明确(如“为我的应用搭建 ClickHouse”),默认本地开发,创建云资源前先询问,因为云服务会产生费用。

使用方式:先检查是否安装 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 需要认证。

适用场景:本地开发或原型验证、迁移到生产托管、操作已有云服务。设计 schema 时可参考 clickhouse-best-practices 技能选择 ORDER BY、数据类型和分区;Postgres 场景使用 infra-postgres 技能。

限制:资料未提供具体命令细节、定价、平台支持范围及云端操作步骤,需查阅对应参考文档。