chDB SQL 查询
原名:chdb-sql
在本地进程中使用 ClickHouse SQL 查询文件和数据源。
中文 Skills 技能说明
适合无需部署服务器的分析、联接和聚合;先用只读查询和小样本验证,批量导出时确认路径与敏感字段。ClickHouse 与 chDB 可在用户自己的环境使用;涉及 ClickHouse Cloud 或托管 PostgreSQL 时,账户、网络、区域、费用与数据位置由用户确认。执行前应读取项目现状和官方文档,输出目标、依据、影响、验证结果与回退方式;没有真实证据时明确说明未知,不编造配置、数据或成功状态。 创建、修改、训练、部署、发布、迁移、删除或产生费用的操作,必须先展示具体目标和差异并获得人工确认。 代码、日志、令牌、连接串、模型、数据集和企业资料按敏感内容处理,只读取任务所需范围,上传或外发前完成授权、脱敏和最小化。
上游能力依据
上游原始适用说明:Use when the user wants to run SQL — especially analytical SQL — on local files (parquet/csv/json), URLs, S3 paths, or remote databases (Postgres, MySQL, MongoDB, ClickHouse Cloud, Iceberg, Delta Lake) without setting up a server. Provides chDB — embedded ClickHouse SQL in Python with 1000+ functions, Session for stateful multi-step pipelines, parametrized queries, and cross-source joins via s3(), mysql(), postgresql(), iceberg(), deltaLake(), remoteSecure() table functions. TRIGGER when: user wants SQL on parquet/csv/files or across remote analytical sources; uses ClickHouse SQL features (window functions, windowFunnel, geoToH3, JSON path ops, Session, parametrized queries); imports chdb or calls chdb.query(). SKIP this skill for pandas-style DataFrame method-chaining (use chdb-datastore instead) or ClickHouse server administration.
上游 SKILL.md 主要章节(保留原文标题):
- Decision Tree: Pick the Right API
- chdb.query() — One Line, Any Data
- Session — Stateful Analysis Pipelines
- Connection API (DB-API 2.0)
- Troubleshooting
- References
使用边界
先确认数据口径、只读或写入权限以及备份方案。查询结果需要说明范围,任何结构或数据变更都应先预览并人工确认。
作者、翻译与许可证
- 原作者
- ClickHouse, Inc. 与 ClickHouse/agent-skills contributors
- 中文翻译
- CEOFans翻译
- 许可证
- Apache-2.0
- 上游来源
- https://github.com/ClickHouse/agent-skills/tree/5aec3114379671f33b1c502a51d420a0729c8172/skills/chdb-sql
适用范围
平台:linux、macos、windows;标签:数据与数据库、chDB SQL 查询
安全提示
基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件,请在最小权限环境中使用,高风险操作必须人工确认。
如发现侵权、许可证或安全问题,可在本页前台提交投诉,管理员复核后可立即下架。