JSON 和 XML 单元格查看器
功能的将 JSON 或 XML 单元格打开为整洁、可探索的结构,而不是一长串标点符号。
在网格行中包含 JSON 或 XML 文档的列是不可读的,它呈现为一行很长的字符串,超出了单元格边界。SQLly 会注意到某个值实际上是文档,并为其提供一个合适的查看器。
单元格是如何被识别的
检测会查看单元格的 原始值 - 真实的原始数据,尚未经过显示格式化和列掩码——并且不依赖列的声明类型。一个值只要开头形式正确且能解析成功,就算作文档:
- JSON - 去除首尾空白后的值以
{或者[和 解析为有效的 JSON。 - XML - 去除首尾空白后的值以
<和 解析为格式良好的 XML。 - YAML - 该值的开头是一个
---文档标记,或者至少包含两个顶层key: value行,再加上更多结构(第三个键、嵌套块或列表项)时,每个顶层行都是 YAML 形状的, 和 并且能通过解析。带冒号的句子,或者两行的备注,会保持为纯文本。 - Markdown - 至少要有两行,包含围栏代码块、表格,或两种不同的 Markdown(标题、列表、块引用、链接、粗体、行内代码)。孤零零一个标题或一小段列表保持为文本。
要求解析成功是刻意的:一个只是以大括号开头的字符串会被原样保留,而不是作为你打不开的文档提供。这正是为什么 nvarchar 列如果存的就是 JSON,会被识别出来,而真正的
json 列如果存的是格式错误的文本,则不会。
打开查看器
- 右键点击 › 打开结构化数据查看器。 始终可用,也是二进制和几何单元格的查看途径。(双击单元格则会改为复制其值。)
- 单元格详情面板。 无论选中哪个单元格,都会以行内方式显示同一个查看器,让你可以开着文档浏览网格。从单元格的右键菜单打开(编辑单元格 › 单元格详细信息),带有 ⌘⌥I (CtrlAltI 在 Windows 和 Linux 上),或者从命令面板打开(切换单元格详细信息面板). 固定 在你四处查看时,它会一直停在同一个单元格上。
查看器内部
- 已美化输出。 文档在导入时会重新缩进。JSON 对象的键会被排序,因此相同的文档总是以相同的方式读取,并且可以逐行比较两行。
- 语法高亮 在原始模式下语法高亮,是一个可滚动的格式化文本视图。
- 树形模式 - 可折叠节点,带实时搜索框和逐节点复制,用来在长到无法滚动的文档里定位某个字段。JSON、XML 和 YAML 都有。
- 预览模式 用于 Markdown:显示渲染后的文本,带标题、列表、表格和代码块;切换到 Raw 可查看高亮显示的源码。
复制美化格式 也在单元格的右键菜单里,位于 复制为,当你想不打开任何界面就把格式化文本放进剪贴板时。
在单元格详细信息面板中编辑值
当结果可编辑时——带键的单表查询、且连接允许更改——面板的值视图中有一个 编辑 按钮。它会在单元格上打开一个宽敞的多行编辑器,比在网格单元格里输入长描述或 JSON 文档容易得多。
- 应用 (或者 ⌘输入, Ctrl输入 在 Windows 和 Linux 上) 阶段 新值会像其他任何网格编辑一样被暂存起来,不会立即写入:该行会显示已暂存标记,在你审核并 保存 (或丢弃)暂存更改之前,不会写入任何内容。 ESC 或者 取消 把草稿扔掉。
- NULL 和空字符串是两回事。 应用空编辑器会暂存一个空字符串; 设为 NULL 暂存 NULL。
- 值会按其所在列进行校验 行编辑器检查字段值的方式(整数列要填整数,日期列要填有效日期,依此类推);如果不符,状态栏会说明原因,你的草稿会保持打开。对于
json或者jsonb列中,非有效 JSON 的文本仍然会被暂存,并在编辑器下方显示警告。 - 长值会先完整加载。 以截断预览形式到达的单元格,要等面板取回完整值之后才能编辑。
- 当无法编辑时 面板会说明原因而不显示编辑选项,例如查询跨了多个表、连接是只读的、列已掩码或是计算列、或者值是二进制(要更改这些,请使用 从文件加载 或十六进制查看器)。
- 已固定的面板 编辑固定的单元格,即使你已经在网格中移到了别处。
其他类型的单元格内容
同一个查看器还负责处理其余放不进网格单元格的内容: 图片 (PNG、JPEG、GIF、WebP、BMP 通过魔数识别并渲染), 二进制 (显示为带 ASCII 侧栏的十六进制转储),以及 几何 数值。