格式化

功能性的

讓數字、日期、ID 和文字更容易瀏覽,而不改變其底層資料。

格式化讓結果集讀起來像個答案,而不是一堆原始資料。SQLly 先從欄位型別給你預設值,你也可以針對單一欄位刻意設定例外。兩種做法都進入同一套格式化模型:

  1. 各類型的預設值。 開啟 設定 › 結果 選擇每種類型在 SQLly 中的顯示方式。
  2. 每欄個別覆寫。 右鍵點擊標題並選擇 格式 › 設定格式覆寫…。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, uuidUUID
其他任何情況 - 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 在格線中。

在本節中

整數
選擇分組方式、符號與單位,讓整數一眼就能讀懂。
小數
選擇小數位數、分組方式與負數樣式,讓含小數的值一目了然。
日期
挑選你要的日期讀法:選擇格式與時區,或把 epoch 數字轉成實際日期。
UUID
保持長識別碼的可辨識性,但不要讓它們佔滿整個網格。
字串
變更大小寫、截斷、套用範本或擷取 JSON 路徑,讓文字欄位一眼就能看懂。