圖表

功能性的

在結果到達之前,告訴圖表分頁該繪製什麼故事。

圖表指示詞會準備結果的 圖表 分頁可以直接用註解產生。圖表和你互動設定出來的相同,但設定會跟著查詢走,每次執行都會自動套用。使用 檢視 指令來開啟圖表分頁,並用一個 chart 指令設定類型、標籤、系列和聚合。

語法

-- 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: 可以單獨放在任一行註解裡。若有多個有效的圖表提示,以最後一個為準。