图表
功能的结果还没返回,就能告诉图表标签页要画一个什么样的故事。
图表指令准备结果的 图表 选项卡。它和你以交互方式配置出的图表是同一个,但设置会随查询一起保存,每次运行时都会回来。使用 查看 指令来打开图表选项卡,再用一个 图表 指令来指定类型、标签、系列和聚合。
语法
-- sqlly view: chart
-- sqlly chart: kind:<type>[; label:<col>][; values:<cols>][; aggregate:<agg>][; order:<order>][; top:<n>][; navigate:<true|false>][; result:<n>]
字段之间的分隔符是 ; 并写为 key:value;顺序无关紧要。只有 kind: 是必需的,其余字段省略时使用图表默认值。列名怎么起都行,因此 [Region], `Region`,以及 "Region" 都解析为同一列。
| 字段 | 含义 |
|---|---|
kind: | 图表类型: bar, line, area, scatter, histogram, pie,或 donut (必填)。 |
label:col | 其值用作类别标签的列。默认为第一个文本列。 |
values:col[,col…] | 要绘制为数据系列的数值列。默认自动检测数值列。 |
aggregate:agg | 按类别折叠行: none, sum, average, minimum, maximum,或 count. (avg/min/max 也接受。) |
order:order | 类别顺序: source, category (A–Z) 或 value (高–低)。 |
top:n | 最多保留 n 个类别。 |
navigate:true|false | 点击标记会在网格选项卡中选中其来源行(默认 true). |
result:n | 图表所属的结果集,从1开始计数。默认为第一个结果。 |
示例
-- sqlly view: chart
-- sqlly chart: kind:bar; label:Region; values:Sales
SELECT Region, Sales FROM sales;
对于两个系列,按类别求和,值最大的显示在最前:
-- sqlly view: chart
-- sqlly chart: kind:line; label:Month; values:Revenue,Cost; aggregate:sum; order:value; top:12
SELECT Month, Revenue, Cost FROM monthly;
当一个批处理返回多个结果集时, result: 会为后面的结果绘制图表:
-- sqlly chart: kind:bar; label:Region; values:Total; result:2
SELECT COUNT(*) FROM sales;
SELECT Region, Total FROM sales;
图表类型
每个 kind: 值会画出不同的标记。下面的图库列出了各自的预期效果;里面的截图占位符还在等待真正的截图。














使用独立的注释行。 放入
view: chart 位于查询的第一条非空行; chart: 可以单独放在任何一行注释里。如果存在多个有效的图表提示,以最后一个为准。