格式化
功能性的讓數字、日期、ID 和文字更容易瀏覽,而不改變其底層資料。
格式化讓結果集讀起來像個答案,而不是一堆原始資料。SQLly 先從欄位型別給你預設值,你也可以針對單一欄位刻意設定例外。兩種做法都進入同一套格式化模型:
- 各類型的預設值。 開啟 設定 › 結果 選擇每種類型在 SQLly 中的顯示方式。
- 每欄個別覆寫。 右鍵點擊標題並選擇 格式 › 設定格式覆寫…。SQLly 會寫入一個
-- sqlly format:將指令納入查詢中,因此選擇會隨著檔案一起傳遞。
數值型和時間型也共用一個 對齊 選項(靠左、置中或靠右),因此下方每一頁都不必重複設定。數字一開始就右對齊,讓位數對齊;日期一開始就左對齊。
SQLly 如何判斷型別
每個欄位的宣告類型決定適用的預設值。你不必自行標記欄位——SQLly 會直接讀取資料庫回報的結果類型:
| 宣告類型(範例) | 格式化為 |
|---|---|
int, bigint, smallint, tinyint, serial, int4, UInt64、MySQL year | 整數 |
decimal, numeric, money, float, real, double、Oracle number | 小數 |
datetime, datetime2, datetimeoffset, timestamp, timestamptz, date, time | 日期 |
uniqueidentifier, uuid | UUID |
其他任何情況 - varchar, nvarchar, text, json… | 文字,原樣儲存 - 請見 字串 每欄選項用 |
即使驅動程式把數值欄位以文字形式傳回,仍會套用數字格式 - SQL Server
decimal 和 money 值,以及 PostgreSQL 和 MySQL 文字協定傳來的所有值,都是這樣抵達的,顯示時會讀回為數字。
頁首的快速選項
設定格式覆寫… 提供一個適合該欄位類型的簡短清單,以及 自訂格式化器… 用於範本、JSON 路徑和數字樣式:
| 欄位類型 | 選擇 |
|---|---|
整數(int, bigint, smallint, tinyint, serial) | 千分位分隔符號、純整數、Epoch 秒 → 日期/時間、Epoch 毫秒 → 日期/時間 |
十進位 / 浮點數(decimal, numeric, money, float, real, double) | 2、4 或 6 位小數,不分組 |
| 日期 / 時間 | 日期(2026-07-14)、日期與時間、日期、時間與位移 |
| 布林 | true / false、Yes / No、1 / 0 |
| 二進位 | 十六進位、Base64 |
| 文字、UUID,及上述未列出的任何類型 | 原始文字、大寫、小寫、遮罩(顯示最後 4 位)、全部遮罩 |
選擇其中一項時,會在查詢上方寫入一行註解;同一欄位再次選擇時會取代該行,而不會再疊加一行:
-- sqlly format: column=OrderID; number=0; thousands=false
-- sqlly format: column=Freight; number=2; thousands=true
SELECT OrderID, CustomerID, Freight
FROM dbo.Orders
WHERE Freight > 100;
哪個規則優先
- 查詢中的指令 對該欄位而言,勝過其他所有設定。指令中的欄位名稱比對時不分大小寫。
- 設定 › 結果 › 欄位覆寫 保存每個欄位的專屬設定,套用於所有查詢,適合像
card_number一律需要遮罩的欄位很有用。若要建立覆寫,請以column來比對任何同名的結果欄位,或依table.column(或者schema.table.column)只會比對該資料表的欄位。當 SQLly 判斷得出結果欄位來自哪個資料表時(來源就是欄位標題工具提示顯示的那一個,或是單一資料表查詢讀取的唯一資料表),就會套用限定鍵,而且對同一個欄位來說,限定鍵優先於不含資料表名稱的鍵。 - 型別預設為 適用於所有其他欄位。
裸鍵必須與結果欄位的名稱完全一致。含限定的鍵比對時不分大小寫,最後一段可以是資料表的欄位名稱,或結果集給它的名稱,所以 orders.total 符合兩者 SELECT o.total 和 SELECT o.total AS order_total。當結果中有來自不同資料表的同名欄位時(SELECT o.id, c.id),僅符合其中一個的限定鍵不會套用;給其中一個欄位取別名以區分它們。
依資料類型上色與語法著色
兩個選用開關位於 設定 › 結果 › 一般 在不編寫任何規則的情況下新增顏色:
- 依資料類型為儲存格上色 為文字、數字、日期和時間、布林值、唯一 ID 和二進位值分別染上各自的顏色。在開關下方,每種類型都有一個 填入 以及一個 文字 顏色選擇器;你選擇的顏色在淺色和深色主題中都會使用,並且 重設為主題色 會回到主題色調。你的條件格式規則仍然優先,且遮罩欄位一律不會套色。
- 為儲存格裡的結構化值標示語法顏色 會在網格裡為 JSON 和 XML 上色——鍵、字串、數字、
true/false/null、標籤、屬性與註解——用你主題的語法顏色上色。涵蓋 JSON 與 XML 欄位,以及看起來像 JSON 或 XML 的文字值。每個儲存格只為可見部分上色,因此非常大的文件也保持流暢;有條件格式文字顏色適用時,則由它接管。
含換行的值在格線中會顯示成單行,每個換行處有一個 ⏎ 顯示每個換行的位置;複製、匯出與儲存格編輯器都會保留實際的換行。
僅顯示
1,234,567.89 複製成
1234567.89 (或與資料庫送出的每個數字一致)。唯一的例外是遮罩:當 將遮罩格式套用於複製與匯出 開啟(預設)時,來自欄位覆寫、敏感欄位規則,以及 mask= 指令的遮罩也會帶入複製和匯出中。請參見 遮罩 和
匯出.
NULL 一律不會套用格式,而是總以斜體顯示為 NULL 在格線中。