database-agent（数据库 Agent）

Database Agent 数据库智能助手

概述

本技能为 Java 后端开发提供智能数据库辅助能力，支持慢 SQL 分析、表结构规范巡检、安全数据订正和测试数据生成等自动化功能。可自动识别索引缺失、全表扫描、字段不规范等问题，生成优化建议与修复脚本；在数据订正时自动校验风险，防止无 WHERE 条件更新删除；并根据表结构智能生成业务合规的测试数据，大幅提升数据库开发与维护效率。

核心能力

1. 慢 SQL 分析

何时使用： 用户报告慢查询、性能问题或需要 SQL 优化时。

功能特性：

• 解析 SQL 执行计划，识别性能瓶颈
• 检测全表扫描、缺失索引和低效 JOIN
• 分析慢查询日志，定位问题查询
• 生成优化建议和索引创建脚本

使用方法：

1. 使用 scripts/analyze_slow_sql.py 分析 SQL 语句或执行计划
2. 参考 references/sql_optimization_rules.md 了解优化模式
3. 生成包含具体建议的报告

示例场景：

• "分析这条慢 SQL：SELECT * FROM orders WHERE user_id = ?"
• "优化这个执行太慢的查询"
• "查找这个查询为什么做全表扫描"

2. 表结构规范巡检

何时使用： 用户需要根据最佳实践和标准验证数据库 schema 时。

功能特性：

• 检查字段命名规范（snake_case、无保留字）
• 验证数据类型和长度
• 检测缺失的主键或索引
• 识别不合规的默认值或可空字段
• 生成规范报告和修复脚本

使用方法：

1. 使用 scripts/check_schema_compliance.py 检查表结构
2. 参考 references/database_standards.md 了解规范规则
3. 使用 scripts/generate_report.py 导出结果到 Excel 报告

示例场景：

• "检查这个表结构是否符合最佳实践"
• "验证我们的数据库 schema 是否符合标准"
• "为所有表生成规范报告"

3. 安全数据订正

何时使用： 用户需要安全地执行批量数据更新或删除时。

功能特性：

• 验证 UPDATE/DELETE 语句的安全风险
• 检测缺失的 WHERE 子句（防止全表更新/删除）
• 识别危险操作（如更新主键）
• 要求对高风险操作进行确认
• 生成备份和回滚脚本

使用方法：

1. 使用 scripts/validate_data_correction.py 检查 SQL 安全性
2. 参考 references/safe_operation_guidelines.md 了解风险模式
3. 执行前必须生成回滚脚本

示例场景：

• "将所有用户状态更新为激活"
• "删除 1 年前的记录"
• "帮我安全地订正这些数据"

关键安全规则：

• 永远不要执行没有 WHERE 子句的 UPDATE/DELETE
• 始终生成备份脚本
• 对影响超过 1000 行的操作要求明确确认
• 记录所有数据订正操作

4. 测试数据生成

何时使用： 用户需要用真实数据填充测试环境时。

功能特性：

• 根据表结构智能生成测试数据
• 遵循外键关系
• 支持自定义数据模式（邮箱、电话、日期）
• 生成业务合规数据（如有效的订单金额、真实的姓名）
• 按正确的依赖顺序创建数据

使用方法：

1. 使用 scripts/generate_test_data.py 创建测试数据
2. 参考 references/test_data_patterns.md 了解数据生成规则
3. 通过 JSON 配置文件配置数量和模式

示例场景：

• "为数据库生成 1000 个测试用户"
• "创建包含真实数据的样本订单"
• "用样本数据填充测试环境"

工作流程

SQL 分析任务

1. 接收 SQL 语句或执行计划
2. 运行 scripts/analyze_slow_sql.py 识别问题
3. 生成优化建议
4. 可选地创建索引创建脚本

Schema 验证任务

1. 连接数据库或接收 DDL 语句
2. 运行 scripts/check_schema_compliance.py
3. 生成规范报告
4. 可选地生成修复脚本

数据订正任务

1. 接收 UPDATE/DELETE SQL 语句
2. 运行 scripts/validate_data_correction.py 进行安全检查
3. 如果安全，生成备份脚本
4. 要求用户确认
5. 执行并记录日志

测试数据生成任务

1. 接收表结构或连接数据库
2. 配置数据模式和数量
3. 运行 scripts/generate_test_data.py
4. 按依赖顺序生成 INSERT 语句

资源

scripts/ 脚本目录

• analyze_slow_sql.py - 分析 SQL 性能并生成优化建议
• check_schema_compliance.py - 根据标准验证表结构
• validate_data_correction.py - 验证数据修改操作的安全性
• generate_test_data.py - 根据表结构生成智能测试数据
• generate_report.py - 导出分析结果到 Excel 格式
• database_connector.py - JDBC 数据库连接工具

references/ 参考文档

• sql_optimization_rules.md - SQL 优化最佳实践和模式
• database_standards.md - 数据库命名约定和设计标准
• safe_operation_guidelines.md - 数据操作的风险模式和安全规则
• test_data_patterns.md - 数据生成模式和业务规则

assets/ 资产文件

• compliance_rules.json - 可配置的规范规则定义
• test_data_config.json - 测试数据生成配置模板
• report_template.xlsx - 规范报告的 Excel 报告模板

重要提示

• 执行数据库操作前始终验证用户权限
• 记录所有操作以便审计追踪
• 为任何数据修改生成回滚脚本
• 首先在非生产环境中测试生成的脚本
• 遵守数据库连接限制和查询超时
• 对大数据量使用批量操作