Sql To Dashboard — 从Sql到仪表盘

当用户提供SQL查询并要求生成图表、仪表板或数据可视化时使用。当用户说“将其显示为图表”、“从此查询创建仪表板”、“可视化结果”或“绘制此数据”时。当用户有查询结果并希望获得视觉摘要而不是原始行时。

核心位置 此技能解决了SQL查询结果是行和列——视觉图表可以使趋势、比较和异常立即可见的问题。 此技能不是： SQL编写或调试工具——它使用用户提供的查询。 数据库管理工具——它不修改模式或数据。 BI平台指南——它生成图表规范，而不是特定于平台的仪表板。 此技能仅在以下情况下激活： SQL查询或结果集 + 可视化/仪表板意图都存在。

模式 /sql-to-dashboard 默认模式。接受SQL查询或结果集并输出图表规范。当用户提供SQL并希望看到数据作为图表时使用。 /sql-to-dashboard/multi 将多个查询组合成一个具有多个面板的仪表板。当用户有多个相关指标希望显示在一个屏幕上时使用。

执行步骤 步骤1 — 分析查询结果 接收SQL查询（粘贴文本或查询结果作为CSV/表格） 如果仅提供查询，则分析它以推断结果结构： SELECT列 → X轴候选项（时间、类别）或Y轴（数值） GROUP BY → X轴或图例分组 ORDER BY with LIMIT → 前N模式，建议水平条形图 COUNT、SUM、AVG聚合 → Y轴值 日期/时间列 → 时间序列 → 线图 字符串/类别列 → 条形图或饼图 识别列类型： 数值（int、float） → 值轴 日期/时间 → 时间轴或类别轴 字符串/类别 → 标签轴、图例或分组

步骤2 — 建议图表类型 查询模式 图表类型 原因 时间序列（GROUP BY日期） 线图 显示时间趋势 前N个COUNT/SUM 水平条形图 易于比较大小 按类别求和 饼图或环图 显示比例 两个数值列 散点图 显示相关性 多个聚合 分组条形图 比较类别之间的组 累计和 面积图 显示累积 是/否计数 环图 二进制比例

步骤3 — 生成仪表板规范 输出适合上下文的规范： Plotly JSON规范： { "data": [{ "x": ["Jan","Feb","Mar"], "y": [120, 80, 150], "type": "scatter", "mode": "lines+markers", "name": "Revenue" }], "layout": { "title": "Monthly Revenue", "xaxis": {"title": "Month"}, "yaxis": {"title": "Revenue ($)"} } } Grafana面板JSON： { "title": "Monthly Revenue", "targets": [{"expr": "sum(revenue)"}], "fieldConfig": {"defaults": {"unit": "currencyUSD"}} } Mermaid（用于简单数据）： xychart-beta title "Monthly Revenue" x-axis [Jan, Feb, Mar] y-axis "Revenue ($)" 0 --> 200 line [120, 80, 150]

步骤4 — 验证 列映射到轴是正确的 图表类型与查询的数据形状匹配 轴标记为列名或派生名称 没有数据值被发明或截断

强制规则 不修改查询 — 使用用户提供的内容 不发明不在结果集中的数据点 不使用饼图显示超过7个类别 不渲染非时间序列数据的线图 保留列名作为轴标签 根据数据形状建议图表类型，即使用户建议了不同的类型 如果结果集为空，则报告“没有返回数据”，而不是渲染空图表

质量标准 良好的输出： 图表类型与查询结果形状匹配 轴正确映射到查询的列 标签和标题从列名派生（不是通用） 规范在目标工具中有效且可渲染（Plotly、Grafana等） 糟糕的输出： 非顺序类别的线图 饼图有20个切片 X轴显示数值作为类别（应为散点图或条形图） 查询返回无数据时渲染空图表（应显式显示“无数据”）

良好与糟糕的示例 场景 糟糕的输出 良好的输出 SELECT日期，COUNT（）按月分组 条形图 时间序列线图 SELECT状态，COUNT（）3个状态 3D饼图 带有图例的环图 空结果集 渲染空图表 “查询返回0行 — 无图表显示” 非常大的结果（10k行） 渲染所有10k个点 聚合或采样 — 显示“显示前100个”

参考 参考/ — 图表类型决策树，Plotly/Grafana/Redash规范模板，仪表板最佳实践