majiayu000 通用数据库查询工具
【通用规范】
参考：通用规范
【查询工作流程】
1. 确定查询目标
- 明确要查询的数据和目的
- 选择合适的数据库和表
- 确定查询范围（单条记录、列表、统计等）
2. 选择查询方法
- SQL 查询：适用于快速查询、批量查询、统计分析
- 使用场景：只提供实例 id、批量查询、统计分析
- MCP 工具：适用于需要详细执行日志的场景
- 使用场景：需要完整执行日志、链路追踪等
3. 执行查询
- 使用
exec_sql工具执行 - 执行前：必须打印完整的目标 SQL 语句（用【】包起来）
- 示例：【SELECT * FROM v3_workflow.workflow_instance WHERE id = 123 AND deleted_at = 0;】
4. 结果分析
- 结构化展示：明确说明查询到的记录数量
- 提取关键字段：展示重要字段的值
- 格式化输出：多条记录使用表格展示，避免直接输出原始 JSON
执行方式
所有查询使用 exec_sql 工具执行，参数替换为实际值。
重要：在执行 SQL 前，必须先打印出完整的目标 SQL 语句，然后再使用 exec_sql 工具执行。
重要：执行 SQL 后，必须对查询结果进行结构化展示：
- 明确说明查询到的记录数量
- 提取并展示关键字段的值
- 多条记录时使用表格或列表形式展示，避免直接输出原始 JSON 数据
通用查询方法
表结构查询
-- 查询表结构（推荐）
DESC database_name.table_name;
-- 查询完整表定义（包含索引、约束等）
SHOW CREATE TABLE database_name.table_name;
-- 查询表状态
SHOW TABLE STATUS LIKE 'table_name';
数据库信息查询
-- 查询所有数据库
SHOW DATABASES;
-- 查询当前数据库
SELECT DATABASE();
-- 查询指定数据库的所有表
SHOW TABLES FROM database_name;
-- 查询表的创建语句
SHOW CREATE TABLE table_name;
基础查询技巧
-- 查询前 N 条记录
SELECT * FROM table_name LIMIT N;
-- 查询去重
SELECT DISTINCT column_name FROM table_name;
-- 查询排序
SELECT * FROM table_name ORDER BY column_name DESC;
-- 查询统计
SELECT COUNT(*) FROM table_name WHERE condition;
-- 条件查询
SELECT * FROM table_name WHERE condition AND deleted_at = 0;
专用数据库查询
常用数据库（有专用 Skill）
- v3_user：查询组织/租户信息，使用 db-user
- v3_openapi：查询连接器/API配置，使用 db-openapi
- v3_metadata：查询事件/按钮/元数据配置，使用 db-metadata
- v3_e-report：查询数据分析告警配置，使用 db-e-report
- v3_workflow：查询工作流相关数据，使用本 skill 的通用方法
注意事项
- 参数替换：所有模板中的
{参数名}都需要替换为实际值 - 删除标记：查询时需注意
deleted_at = 0条件（如果表有软删除字段） - 执行方式：必须通过 MCP 工具
exec_sql执行 - 数据唯一性：不同
org_id下可能存在相同的id，这是不同的数据记录