通用数据库查询工具

【通用规范】

参考：通用规范

执行方式

所有查询使用 exec_sql 工具执行，参数替换为实际值。

重要：在执行 SQL 前，必须先打印出完整的目标 SQL 语句，然后再使用 exec_sql 工具执行。

重要：执行 SQL 后，必须对查询结果进行结构化展示：

• 明确说明查询到的记录数量
• 提取并展示关键字段的值
• 多条记录时使用表格或列表形式展示，避免直接输出原始 JSON 数据

通用查询方法

表结构查询

-- 查询表结构
DESC table_name;
SHOW COLUMNS FROM 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;

专用数据库查询

常用数据库（有专用 Skill）

• v3_user：查询组织/租户信息，使用 op-db-user
• v3_openapi：查询连接器/API配置，使用 op-db-openapi
• v3_metadata：查询事件/按钮/元数据配置，使用 op-db-metadata
• v3_e-report：查询数据分析告警配置，使用 op-db-e-report

注意事项

1. 参数替换：所有模板中的{参数名}都需要替换为实际值
2. 删除标记：查询时需注意 deleted_at = 0 条件
3. 执行方式：必须通过 MCP 工具 exec_sql 执行