SuperAPI AI 工具集

cockroachdb-sql

数据与分析

查看项目

更新于 10-15 19:50

技能介绍

用途:把自然语言问题转换为符合 CockroachDB 规范的 SQL,覆盖模式设计、查询编写与查询优化,聚焦 CockroachDB 本身而非数据库迁移转换。

主要能力:识别操作类型(SELECT、INSERT、UPDATE、DELETE、CREATE、ALTER 等);收集上下文(复用会话中已有模式,或通过 SHOW TABLES;、SHOW CREATE TABLE table_name; 查询现有结构,必要时询问表结构、列数据类型、索引需求、多区域需求与性能特征);按 references/cockroachdb-rules/ 中的规则应用最佳实践,规则分为 00-fundamental-principles.md(始终优先)、01-schema-design.md、02-dml-operations.md、03-query-patterns.md、04-optimization.md、05-operational.md,并对照 04 中的反模式校验。

使用方式:技能调用时先检测连接。若提示中提供连接串(postgresql://...),用 cockroach sql --url "<provided-url>" -e "SQL" 执行,不使用 psql;否则检查 COCKROACH_URL 环境变量(echo $COCKROACH_URL),若已设置则用 cockroach sql --url $COCKROACH_URL -e "SQL";再否则检查 cockroach-cloud MCP 服务器是否可用;均不可用或集群不明确时先询问用户。连接数据库后必须对每条生成的 SQL 运行 EXPLAIN,若返回解析或语法错误则修正并重跑直至通过,并在回复中附上 EXPLAIN 输出。

输出与示例:展示带解释性注释的 SQL,列出所用 CockroachDB 特有特性与性能考量,并给出所用规则引用;优化时每步先说明目的、再执行并报告结果、最后汇总发现与操作。资料给出的示例包括使用 UUID 主键避免热点、用 UNNEST 批量 UPSERT、用键集分页替代 OFFSET。

限制:资料未提供收费、价格、平台支持范围等信息;实际可用性取决于是否具备连接串、环境变量或 MCP 服务器。