ClickHouse 最佳实践

原名：clickhouse-best-practices

按官方规则审查表设计、查询、写入、分区和物化视图。

中文 Skills 技能说明

适合建表、性能优化和代码审查；建议必须结合实际 explain、系统表和负载证据，不能机械套用规则。ClickHouse 与 chDB 可在用户自己的环境使用；涉及 ClickHouse Cloud 或托管 PostgreSQL 时，账户、网络、区域、费用与数据位置由用户确认。执行前应读取项目现状和官方文档，输出目标、依据、影响、验证结果与回退方式；没有真实证据时明确说明未知，不编造配置、数据或成功状态。 创建、修改、训练、部署、发布、迁移、删除或产生费用的操作，必须先展示具体目标和差异并获得人工确认。 代码、日志、令牌、连接串、模型、数据集和企业资料按敏感内容处理，只读取任务所需范围，上传或外发前完成授权、脱敏和最小化。

上游能力依据

上游原始适用说明：MUST USE when reviewing ClickHouse schemas, queries, or configurations. Contains 31 rules that MUST be checked before providing recommendations. Always read relevant rule files and cite specific rules in responses.

上游 SKILL.md 主要章节（保留原文标题）：

• IMPORTANT: How to Apply This Skill
• Agent Connectivity & Query Workflow
• Subagent architecture notes
• Review Procedures
• For Schema Reviews (CREATE TABLE, ALTER TABLE)
• For Query Reviews (SELECT, JOIN, aggregations)
• For Insert Strategy Reviews (data ingestion, updates, deletes)
• Output Format
• Rules Checked
• Findings

使用边界

先确认数据口径、只读或写入权限以及备份方案。查询结果需要说明范围，任何结构或数据变更都应先预览并人工确认。

作者、翻译与许可证

原作者

ClickHouse, Inc. 与 ClickHouse/agent-skills contributors

中文翻译

CEOFans翻译

许可证

Apache-2.0

上游来源

https://github.com/ClickHouse/agent-skills/tree/5aec3114379671f33b1c502a51d420a0729c8172/skills/clickhouse-best-practices

适用范围

平台：linux、macos、windows；标签：数据与数据库、ClickHouse 最佳实践

安全提示

基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件，请在最小权限环境中使用，高风险操作必须人工确认。

如发现侵权、许可证或安全问题，可在本页前台提交投诉，管理员复核后可立即下架。