SQL Master Skill

目标

帮助用户执行SQL、优化SQL、分析SQL质量、理解数据结构。

何时使用

当用户提到以下关键词时使用此skill：

核心命令（9个）

1. 执行SQL

dbskiter --output-mode=ai --database=<数据库名> sql execute "<SQL语句>"

参数：

• --params='{"key": "value"}'：SQL参数（JSON格式）
• --limit=100：限制返回行数

示例：

# 基础查询
dbskiter --output-mode=ai --database=prod sql execute "SELECT * FROM users LIMIT 10"

# 带参数
dbskiter --output-mode=ai --database=prod sql execute "SELECT * FROM users WHERE age > %(age)s" --params='{"age": 18}'

# 限制返回行数
dbskiter --output-mode=ai --database=prod sql execute "SELECT * FROM orders" --limit=50

2. 重写SQL优化

dbskiter --output-mode=ai --database=<数据库名> sql rewrite "<SQL语句>"

功能：

• 展开 SELECT * 为具体字段
• 优化 WHERE 条件
• 推荐索引
• 重写低效JOIN

示例：

# 优化SELECT *
dbskiter --output-mode=ai --database=prod sql rewrite "SELECT * FROM users WHERE id = 1"
# 输出：SELECT id, name, email FROM users WHERE id = 1

# 优化复杂查询
dbskiter --output-mode=ai --database=prod sql rewrite "SELECT * FROM orders o JOIN users u ON o.user_id = u.id WHERE u.status = 'active'"

3. 分析SQL质量

dbskiter --output-mode=ai --database=<数据库名> sql analyze "<SQL语句>"

输出：

• 质量评分（0-100分）
• 等级（A/B/C/D/F）
• 问题列表
• 优化建议

评分标准：

• 90-100分：A级（优秀）
• 80-89分：B级（良好）
• 70-79分：C级（一般）
• 60-69分：D级（较差）
• <60分：F级（危险）

示例：

dbskiter --output-mode=ai --database=prod sql analyze "SELECT * FROM users WHERE email = 'test@test.com'"

4. 数据分析

dbskiter --output-mode=ai --database=<数据库名> sql data "<查询SQL>"

功能：分析查询结果的数据特征

• 每列的数据类型
• 空值数量
• 唯一值数量
• 数值列的统计（最小/最大/平均值）
• 示例值

示例：

# 分析订单数据
dbskiter --output-mode=ai --database=prod sql data "SELECT * FROM orders WHERE created_at > '2024-01-01'"

# 分析用户数据
dbskiter --output-mode=ai --database=prod sql data "SELECT age, city, status FROM users"

5. SQL智能补全

dbskiter --output-mode=ai --database=<数据库名> sql complete "<部分SQL>"

功能：根据部分SQL提供补全建议

• 表名补全
• 字段名补全
• SQL关键字补全
• 函数补全

示例：

# 补全表名
dbskiter --output-mode=ai --database=prod sql complete "SELECT * FROM "

# 补全字段
dbskiter --output-mode=ai --database=prod sql complete "SELECT id, name, "

# 补全WHERE条件
dbskiter --output-mode=ai --database=prod sql complete "SELECT * FROM users WHERE "

6. Schema查询

# 列出所有表
dbskiter --output-mode=ai --database=<数据库名> sql schema

# 查看指定表结构
dbskiter --output-mode=ai --database=<数据库名> sql schema --table=<表名>

输出：

• 所有表名列表
• 表字段详情（名称、类型、是否可空、默认值）
• 索引信息

示例：

# 列出所有表
dbskiter --output-mode=ai --database=prod sql schema

# 查看users表结构
dbskiter --output-mode=ai --database=prod sql schema --table=users

# 查看orders表结构和索引
dbskiter --output-mode=ai --database=prod sql schema --table=orders

7. 导出数据

# 导出表数据
dbskiter --output-mode=ai --database=<数据库名> sql export --table=<表名> --output=<文件路径> --format=<格式>

# 导出查询结果
dbskiter --output-mode=ai --database=<数据库名> sql export --query="<SQL>" --output=<文件路径> --format=<格式>

参数：

• --table: 表名（与--query二选一）
• --query: SQL查询语句（与--table二选一）
• --output, -o: 输出文件路径（必需）
• --format, -f: 导出格式（csv/json/sql，默认csv）
• --where: WHERE条件（仅table模式）
• --limit: 限制导出行数

示例：

# 导出users表为CSV
dbskiter --output-mode=ai --database=prod sql export --table=users --output=users.csv

# 导出为JSON格式
dbskiter --output-mode=ai --database=prod sql export --table=users --output=users.json --format=json

# 导出查询结果
dbskiter --output-mode=ai --database=prod sql export --query="SELECT * FROM orders WHERE status='pending'" --output=pending_orders.csv

# 只导出前1000行
dbskiter --output-mode=ai --database=prod sql export --table=users --output=users.csv --limit=1000

8. 导入数据

dbskiter --output-mode=ai --database=<数据库名> sql import <文件路径> --table=<表名> --format=<格式>

参数：

• --table, -t: 目标表名（必需）
• --format, -f: 文件格式（csv/json/sql，默认csv）
• --columns: 指定列名（逗号分隔，CSV格式用）
• --batch-size: 批量插入大小（默认1000）

示例：

# 从CSV导入
dbskiter --output-mode=ai --database=prod sql import users.csv --table=users

# 从JSON导入
dbskiter --output-mode=ai --database=prod sql import users.json --table=users --format=json

# 从SQL文件导入
dbskiter --output-mode=ai --database=prod sql import users.sql --format=sql

# 指定列名导入
dbskiter --output-mode=ai --database=prod sql import data.csv --table=users --columns=id,name,email

# 调整批量大小
dbskiter --output-mode=ai --database=prod sql import large_data.csv --table=users --batch-size=500

9. 批量执行SQL文件

dbskiter --output-mode=ai --database=<数据库名> sql batch <文件路径>

功能：批量执行文件中的SQL语句

示例：

# 批量执行SQL文件
dbskiter --output-mode=ai --database=prod sql batch queries.sql

AI决策流程

场景1：用户说"执行这个SQL"

步骤1：提取用户提供的SQL
步骤2：执行 dbskiter --output-mode=ai --database=<name> sql execute "<SQL>"
步骤3：展示结果（最多50行）
步骤4：告知总行数和耗时

场景2：用户说"优化这个SQL"

步骤1：提取用户提供的SQL
步骤2：执行 dbskiter --output-mode=ai --database=<name> sql rewrite "<SQL>"
步骤3：展示优化后的SQL和解释
步骤4：如果质量评分<80，建议进一步优化

场景3：用户说"查看表结构"

步骤1：提取表名
步骤2：执行 dbskiter --output-mode=ai --database=<name> sql schema --table=<表名>
步骤3：展示表结构和索引信息