ClickHouse 数据库分析助手
核心用法
该 Skill 通过 ClawLink 集成中心连接到用户自有的 ClickHouse 实例,提供基于 HTTP API 的数据库探索与查询能力。用户无需配置 API 密钥或连接字符串,通过三步完成配对后即可在聊天中直接调用工具。主要功能分为两类:模式发现(列出数据库、表、获取表结构)和查询执行(运行只读 SQL)。工作流强调"先探索模式、后执行查询"——要求先调用 clickhouse_list_databases 和 clickhouse_get_database_schema 理解数据结构,再提交针对性 SQL。
显著优点
- 零配置接入:ClawLink 托管凭证,用户无需管理 API 密钥或连接串
- 安全沙箱:工具层仅暴露只读操作,天然阻断 INSERT/ALTER/DROP 等风险指令
- 交互友好:提供
clickhouse_get_play_interface直达 ClickHouse Play Web UI,支持 Monaco 编辑器手动编写复杂查询 - 实时工具目录:通过
clawlink_list_tools动态获取可用工具列表,避免硬编码假设
潜在局限
- 只读限制:无法执行数据写入或 schema 变更,不适合数据工程任务
- 资源敏感:大型表的全表扫描或复杂 GROUP BY 可能触发确认流程,影响流畅度
- 生态依赖:ClawLink 作为中间层,若其服务中断则完全不可用;且目前仅支持 HTTP API 模式
适合人群
- 业务分析师、BI 工程师需要快速探查 ClickHouse 中的指标数据
- 运维人员需要临时验证数据分布或排查异常值
- 不想配置 JDBC/CLI 工具、偏好对话式查询的技术用户
常规风险
- 查询性能风险:用户可能无意识提交高开销查询(如无索引字段的全表扫描),建议始终携带
WHERE和LIMIT - 模式漂移:ClawLink 工具列表为运行时动态获取,若 ClickHouse 端 schema 变更,需重新获取工具目录以避免
TableNotFound - 凭证托管风险:虽然 ClawLink 承诺安全存储 API 密钥,但用户需信任第三方托管平台的密钥管理实践