圖表
功能性的在結果到達之前,告訴圖表分頁該繪製什麼故事。
圖表指示詞會準備結果的 圖表 分頁可以直接用註解產生。圖表和你互動設定出來的相同,但設定會跟著查詢走,每次執行都會自動套用。使用 檢視 指令來開啟圖表分頁,並用一個 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: 值會畫出不同的標記。下方的展示區列出各種情況該有的樣子;截圖預留位置還在等實際截圖補上。














使用獨立的註解行。 放置
view: chart 在查詢的第一個非空白行上; chart: 可以單獨放在任一行註解裡。若有多個有效的圖表提示,以最後一個為準。