樞紐分析
功能性的只靠一句簡短、可攜的註解,就能把熟悉的結果集變成樞紐分析表。
樞紐分析指令能把平面的結果集變成交叉表,不需要精靈或額外工具。請使用 檢視 指令來開啟樞紐分析模式,並用一個 樞軸 指令描述列、欄和數值。
語法
-- sqlly view: pivot
-- sqlly pivot: row:<cols>; column:<cols>; value:<col>:<agg>
欄位之間以 ; 並寫作 key:value;它們的順序不重要。 value: 為必填,另外還須至少一個 row: ,另外,只按列分組的樞紐分析表是很好用的分組摘要:
| 欄位 | 意義 |
|---|---|
row: | 一或多個欄位名稱(以逗號分隔),作為樞紐分析的列。 |
column: | 一或多個欄位名稱,作為樞紐分析的欄。 |
value:col:agg | 要彙總的欄位,以及要套用的彙總方式。 |
result:N | 可選。樞紐分析所屬的結果集,從 1 起算;留空即代表第一個結果。 |
選擇 count, sum, avg, min, max,或 first 作為彙總。欄位名稱很彈性: [Region], `Region`,而且 "Region" 都解析為同一個欄位。
範例
-- sqlly view: pivot
-- sqlly pivot: row:Region; column:Year; value:Sales:sum
SELECT Region, Year, Sales FROM sales;
以下是一個有兩個列欄位的樞紐分析表,並為其值儲存格設定格式:
-- sqlly view: pivot
-- sqlly pivot: row:Region,Country; column:Year; value:Amount:sum; valueformat:decimals=2, red=true
SELECT Region, Country, Year, Amount FROM ledger;
當一個批次傳回多個結果集時, result: 會將樞紐分析表放在後面的某個結果集中。這裡的樞紐分析表屬於第二個 SELECT:
-- sqlly pivot: row:Region; value:Total:sum; result:2
SELECT COUNT(*) FROM sales;
SELECT Region, Total FROM sales;
可選格式化
兩個選填欄位用來格式化數字。 valueformat: 對所有值儲存格應用樣式; format:col: 為單一欄位套用樣式。兩者都接受字詞 default 或逗號分隔的選項清單:
| 選項 | 值 |
|---|---|
decimals= | 非負整數 - 固定小數位數。 |
thousands= | true / false - 千位分隔符號。 |
red= | true / false - 負數顯示為紅色。 |
parens= | true / false - 以括號標示負數。 |
align= | left / center / right. |


使用獨立的註解行。 A
view: 提示應放在查詢的第一個非空行; pivot: 可以單獨放在任一行註解裡。若有多個有效的樞紐分析提示,以最後一個為準。