格式化

功能的

让数字、日期、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)千位分隔符,普通整数,时间戳(秒)→ 日期/时间,时间戳(毫秒)→ 日期/时间
小数 / 浮点数 (decimal, numeric, money, float, real, double)2、4 或 6 位小数,无分组
日期 / 时间日期 (2026-07-14)、日期和时间,以及日期、时间和偏移
布尔值真 / 假,是 / 否,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 在网格中。

在本节中

整数
选择让整数一目了然的分组、符号和单位。
小数
选择小数位、分组和负数样式,使小数值清晰易读。
日期
按你的方式读取日期:自选格式和时区,或把时间戳数字转换为真实日期。
UUID
让长标识符保持可辨认,又不会占据整个网格。
字符串
更改大小写、截断、套用模板或提取 JSON 路径,让文本列一眼看去依然有用。