字串

功能性的

變更大小寫、截斷、套用範本或擷取 JSON 路徑,讓文字欄位一眼就能看懂。

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

SQLly
SQLly 每欄字串格式化選擇器對話方塊SQLly 每欄字串格式化選擇器對話方塊
逐欄格式化工具的選擇器,顯示「範本」、「JSON 路徑」與「數字」分頁。

範本

使用 {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…
123ORD-{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.nameAda
$.items[1].skuB2
$.items[0]{"sku":"A1"}
$.missing(空)

字串不帶引號顯示;數字, true/false,而且 null 會照原樣顯示;物件與陣列則顯示為精簡 JSON。當路徑無法解析,或儲存格不是有效的 JSON 時,儲存格會空白,或顯示你設定該欄位時在 設定 › 結果 › 欄位覆寫,其中包含一個 如果遺失 欄位。複製與匯出會保留完整 JSON;想瀏覽整份文件,請開啟 JSON 與 XML 儲存格檢視器.

數字

以你選定的小數位數和千位分組方式套用數字樣式:

樣式值網格顯示(小數點後 2 位)
已修正1234567.8911,234,567.89
百分比 (×100,新增 %)0.123412.34%
位元組 (B / KiB / MiB / GiB / TiB,以 1024 為級距)15361.50 KiB
位元組512512 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= 指令,就像遮罩覆蓋中的一樣 設定 › 結果 › 欄位覆寫,會遮罩表格,複製與匯出時也同樣套用—— 將遮罩格式套用於複製與匯出 已開啟。這裡的其他格式只會改變網格畫出來的樣子——見 遮罩.