字符串
功能的更改大小写、截断、套用模板或提取 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= 规则,因此它会作用于数字列。Bytes 在低于 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= 指令,就像 设置 › 结果 › 列覆盖,会遮盖网格,而且复制和导出时也同样打码,只要 在复制和导出时应用掩码格式 处于开启状态。这里的其他格式只会改变网格绘制的内容——参见 掩码.