字串
功能性的變更大小寫、截斷、套用範本或擷取 JSON 路徑,讓文字欄位一眼就能看懂。
文字以儲存時的樣子呈現,沒有一體適用的預設面板。當某個欄位需要協助時,在其標題上按右鍵並選擇 格式 › 設定格式覆寫…。文字欄位的快速清單提供 原始文字,
大寫, 小寫, 遮罩(顯示最後 4 位),而且 全部遮罩. 自訂格式化器…
會開啟一個挑選器,把更豐富的選項收進三個分類分頁,每個分頁都有即時預覽。無論你選擇什麼,都會作為
-- sqlly format:
行。


範本
使用 {value} 佔位符,搭配管線輔助工具來做大小寫轉換、截斷、填充,以及其他能讓文字更易讀的小調整:
| 輔助函式 | 效果 |
|---|---|
upper / lower | 變更大小寫。 |
trunc:N | 截斷為 N 個字元,並加上省略號。 |
prefix:S / suffix:S | 在開頭/結尾加上字面文字。 |
pad:N | 在左側補空格至寬度 N。 |
default:S | 當值為空時以 S 取代。 |
輔助函式從左到右執行,並且大括號外的文字保持原樣:
| 值 | 範本 | 網格顯示 |
|---|---|---|
ada | {value|upper} | ADA |
abcdef | {value|trunc:3} | abc… |
123 | ORD-{value|pad:6} | ORD- 123 |
12 | {value|prefix:$|suffix: USD} | $12 USD |
| (空字串) | {value|default:n/a} | n/a |
- NULL 就維持 NULL。 範本完全跳過 NULL 儲存格,因此
default:只會填入空字串。 - 字面大括號 會寫成兩個連續字元:
{{和}}. - 錯字會自己現形。 未知的輔助函式會讓預留位置保持原樣顯示,例如
{value|nope},而不是默默捨棄文字。 - 不能有分號。 該指令以分號分隔,因此選擇器不會接受包含
;.
-- sqlly format: column=code; template={value|upper}
-- sqlly format: column=notes; template={value|trunc:40}
JSON 路徑
從 JSON 文字欄位中擷取有用的葉節點,例如 $.customer.name
或 $.items[0]。路徑使用點分段, [n] 索引,以及為含空格的名稱加上引號的鍵($["first name"])。對於一個
payload 的
{"customer":{"name":"Ada"},"items":[{"sku":"A1"},{"sku":"B2"}]}:
| 路徑 | 網格顯示 |
|---|---|
$.customer.name | Ada |
$.items[1].sku | B2 |
$.items[0] | {"sku":"A1"} |
$.missing | (空) |
字串不帶引號顯示;數字, true/false,而且
null 會照原樣顯示;物件與陣列則顯示為精簡 JSON。當路徑無法解析,或儲存格不是有效的 JSON 時,儲存格會空白,或顯示你設定該欄位時在 設定 › 結果 › 欄位覆寫,其中包含一個 如果遺失 欄位。複製與匯出會保留完整 JSON;想瀏覽整份文件,請開啟
JSON 與 XML 儲存格檢視器.
數字
以你選定的小數位數和千位分組方式套用數字樣式:
| 樣式 | 值 | 網格顯示(小數點後 2 位) |
|---|---|---|
| 已修正 | 1234567.891 | 1,234,567.89 |
百分比 (×100,新增 %) | 0.1234 | 12.34% |
| 位元組 (B / KiB / MiB / GiB / TiB,以 1024 為級距) | 1536 | 1.50 KiB |
| 位元組 | 512 | 512 B |
百分比與位元組格式適用於任何值讀起來像數字的欄位——包括以文字儲存的數字,例如一個 varchar 大小。非數字的值會保持原樣。固定模式會存成純 number= 規則,因此會套用數字欄位的樣式。「位元組」在低於 1 KiB 時一律顯示整數位元組,且不使用千位分隔。
-- sqlly format: column=size_bytes; number=2; style=bytes; thousands=true
-- sqlly format: column=hit_rate; number=1; style=percent; thousands=true
SELECT name, size_bytes, hit_rate FROM cache_stats;
每個欄位一個規則
每個欄位只能套用一個格式化規則。對同一欄位再次選擇會取代查詢中的該行,如果兩行手動指定同一欄位,則後者優先。所以範本和數字樣式不能疊加在同一欄位上。
相關:敏感文字可以透過 mask= 覆寫。 mask= 指令,就像遮罩覆蓋中的一樣 設定 › 結果 › 欄位覆寫,會遮罩表格,複製與匯出時也同樣套用—— 將遮罩格式套用於複製與匯出 已開啟。這裡的其他格式只會改變網格畫出來的樣子——見 遮罩.