图表

功能的

结果还没返回,就能告诉图表标签页要画一个什么样的故事。

图表指令准备结果的 图表 选项卡。它和你以交互方式配置出的图表是同一个,但设置会随查询一起保存,每次运行时都会回来。使用 查看 指令来打开图表选项卡,再用一个 图表 指令来指定类型、标签、系列和聚合。

语法

-- 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: 值会画出不同的标记。下面的图库列出了各自的预期效果;里面的截图占位符还在等待真正的截图。

SQLly
SQLly 条形图SQLly 条形图
kind:bar,围绕零基线的分组条形图,每个类别中每个系列一根条形。
SQLly
SQLly 折线图SQLly 折线图
kind:line,每个系列一条折线,NULL 处有间隙。
SQLly
SQLly 面积图SQLly 面积图
kind:area,在以零为底的坐标轴上绘制填充折线图。
SQLly
SQLly 散点图SQLly 散点图
kind:scatter,按类别的点标记,适合显示分布。
SQLly
SQLly 直方图SQLly 直方图
kind:histogram,对单个数值列划分出的边界规整的分箱。
SQLly
SQLly 饼图SQLly 饼图
kind:pie,单个非负系列的径向占比。
SQLly
SQLly 圆环图SQLly 圆环图
kind:donut——中心镂空的饼图。
使用独立的注释行。 放入 view: chart 位于查询的第一条非空行; chart: 可以单独放在任何一行注释里。如果存在多个有效的图表提示,以最后一个为准。