技能说明
适合 ClickHouse 或 ClickHouse Cloud 的表设计、查询调优和数据写入方案；技能覆盖 31 条按影响排序的规则，也适用于 chdb 相关分析。生产改动前请结合真实查询、数据量和版本验证。
关于此技能
ClickHouse 官方数据库实践技能，把表设计、查询优化和数据写入中的关键取舍整理成按影响排序的规则。
核心能力
表结构与主键
帮助选择数据类型、ORDER BY 和 PRIMARY KEY，并结合分区、跳过索引和物化视图设计分析表。
查询与 JOIN 优化
覆盖 JOIN 组织、过滤、聚合和避免不必要 mutation 等高影响规则，适合定位慢查询和资源浪费。
高效写入
提醒批量写入、异步插入、JSON 使用和其他数据摄取边界，减少小批次和错误建模带来的开销。
适用场景
设计 ClickHouse 表
从访问模式、数据类型、排序键和分区策略出发建立分析型表结构。
优化慢查询
检查 JOIN、过滤、聚合、索引和查询形态，形成可验证的优化方案。
规划数据摄取
设计批量写入、异步插入和物化视图流程，兼顾吞吐、延迟和可维护性。
使用步骤
- 01
第一步：说明工作负载
提供数据量、写入频率、查询模式、延迟目标、JOIN 关系和 ClickHouse 版本。
- 02
第二步：应用高影响规则
先检查主键、数据类型、排序键、分区、JOIN 和批量写入，再处理次要优化。
- 03
第三步：用真实数据验证
结合 EXPLAIN、查询日志和代表性数据测试，确认性能、成本和结果正确性后再上线。
常见问题
它只适用于 ClickHouse Cloud 吗？+
不是。README 说明它可用于开源 ClickHouse 和 ClickHouse Cloud；具体命令和权限需按部署方式调整。
会自动改表或删除数据吗？+
不会。它提供设计和优化建议，不应替代变更审批、备份、回滚和生产验证。
许可证是什么？+
仓库 README 标注 Apache-2.0，使用时请遵守仓库许可。
安装前检查
把兼容性、来源和安装入口先看清楚，再放进自己的工作流。
Claude Code · Codex · Cursor
已提供来源链接
命令可直接复制
2026/08/30
安装提醒：这项技能可能涉及网络、脚本、文件或凭据权限，安装前请先阅读 SKILL.md，并确认它需要哪些权限。
npx skills add clickhouse/agent-skills