字符串

功能的

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