值格式

功能的

可以将值查看为 UTF-8、JSON、十六进制、MessagePack、Base64、Protobuf,或解压后的 gzip、zstd 和 LZ4,并会记住你为每个键选择的格式。

值查看器可以以你选择的格式显示一个值,而不仅仅是它检测到的格式。打开一个值, 打开值 在 Redis 键上,然后 在值查看器中打开… 或者 以十六进制查看… 在其结果单元格上,或者 预览有效负载 在 Pub/Sub 查看器中,并使用查看器工具栏中的 格式 查看器工具栏中的菜单。菜单是分组的:先是普通视图,然后是编码,再是压缩,最后是语言序列化器。格式只影响显示:无论选哪种,键里存储的字节都不会变。

  • 自动 - 检测到的视图(JSON、XML、图像、几何或文本)。当这些都不匹配时,自动视图还会查看前导字节和值的结构,并识别 gzip、zstd、LZ4、zlib、Java 序列化、Python pickle、PHP serialize,Base64 和 Protobuf;找到的内容会在菜单旁标注(“自动:gzip → JSON (1,234 → 5,678 字节)”)。结构嗅探是刻意保守的:整个值必须能解析,而且只有长度不少于 16 个字符、解码后的字节是可读内容的值,才会被猜测为 Base64,因此一个普通单词、一个十六进制 ID,或者像 user:42 仍保持为文本。
  • UTF-8 - 将字节作为文本显示;无效的 UTF-8 会用替代字符显示,并附带说明。
  • JSON - 以树状视图进行美化显示;如果值不是有效的 JSON,则保持原始文本并附带说明。
  • YAML - 带高亮显示,与可搜索的树状 JSON 相同;如果值不是 YAML 映射或列表,则保持原始文本并附带说明。
  • Markdown - 在 Raw 模式下高亮,并渲染(标题、列表、表格、代码块、链接)到 预览 模式。
  • 十六进制 - 标准十六进制转储。
  • MessagePack - 解码成 JSON,供树状视图和高亮使用。二进制字段显示为 {"$binary": "<hex>"},标准时间戳显示为 {"$timestamp": "2023-11-14T22:13:20Z"},其他扩展值显示为 {"$ext": {"type": n, "data": "<hex>"}},以及键会作为 JSON 对象键发生冲突的映射(一个整数 1 在字符串旁边 "1",或者重复键)作为 {"$map": [[key, value], …]} ,以保证没有条目丢失。无效的 MessagePack 数据负载将回退到十六进制转储,并显示解码器的原因。
  • Base64 - 标准或 URL 安全格式均可,带不带填充都行,换行会被忽略。解码后的字节会按其本来面目显示:JSON 或 XML 树、文本、可识别的序列化格式,或十六进制转储。
  • Protobuf - 一条不依赖模式即可遍历的 protocol-buffers 消息,因此任何消息都能查看:字段编号成为键,varint 显示为数字,定宽字段同时给出整数和浮点两种读数({"$fixed64": …, "$double": …}),长度限定字段在能按文本解读时显示为文本,能按嵌套消息解读时显示为嵌套消息,否则显示为 {"$bytes": "<hex>"} 。重复字段会变成数组。字段名需要消息的 schema:请先注册你的 .proto 文件注册在 设置 › 结果 › Protobuf 架构 (见下文)。
  • gzip - zstd, LZ4, deflate,数值会被解压,结果显示其内容(JSON 和 XML 显示为树,PHP、Java、pickle 和 Protobuf 载荷显示为解码结果,文本显示为文本,其他显示为十六进制转储),并附注解压前后的大小。每次只解一层:压缩流里再嵌压缩流时,只在附注中说明,不会继续解压。LZ4 同时接受帧格式和前置了原始大小的裸块;deflate 接受 zlib 包装流和裸流。zstd 在 SQLly 的浏览器版中不可用,菜单里会注明。
  • PHP 序列化 - serialize() 输出解码为 JSON:列表变为数组,其他数组为对象,对象 {"$class": "Name", "$properties": {…}} 带有受保护和私有属性名称拼写 protected:name 和 private:Class:name、引用 {"$ref": n},以及一个不是 UTF-8 的字符串 {"$bytes": "<hex>"}.
  • Java 序列化 - 一个 ObjectOutputStream 有效负载通过其头部识别并加以摘要:包括流版本、它携带的类及其 serialVersionUID,以及其中的字符串。字段值未解码;这需要类本身。
  • Python pickle - 协议 2 及以上版本的 pickle 通过文件头即可识别并加以概述:协议、操作码计数、全局变量(module.name)所引用的对象、其字符串的样本,以及它是否干净地结束。对象绝不会被重新构建,那将意味着运行 pickle 中的指令。

每个解码器都把值当作不可信输入。解压输出上限 16 MB,如果 gzip 尾部、zstd 帧头或 LZ4 块前缀声称会超过这个上限,解压开始前就会拒绝;截断或损坏的流会按解码器给出的理由报告为不可解码,绝不会显示成部分输出。Protobuf 和 PHP 的嵌套在 128 层截止,值内部的每个长度都会对照实际存在的字节检查,任何无法对每个字节作出解释的遍历器都会拒绝整个值。

使用你自己的 Protobuf 模式

在 设置 › 结果 › Protobuf 架构, 添加 .proto 文件… 注册一个或多个 .proto 文件(文件所在文件夹就是它的 import会被查找,而标准的 google/protobuf/* 类型是内置的),并且 添加描述符集… 从 protoc --descriptor_set_out。每个模式都会与其消息类型一并列出;若无法读取,则列出编译器给出的原因。 重新加载 在你更改文件后重新读取文件,并且 删除 会注销其中一个,且不会改动文件。

注册了 schema 之后,以 Protobuf 显示的值会多出一个 消息 在“格式”菜单旁边的菜单。选择一个消息类型,值就会在 JSON 树中用真实字段名解码——嵌套消息、按名称显示的枚举、作为数组的重复字段、按数字处理的 64 位数字。值中携带但消息未定义的字段会在备注中按编号列出。如果值完全不符合该消息(某个字段的线类型不对,或者没有任何字段属于该消息),或者模式后来已被移除,查看器会退回到不依赖模式的字段编号视图,并说明原因。消息类型的记忆方式与格式一样:对于 Redis 键,跨重启也会记住(在 protobuf-schemas.json 在 SQLly 的数据文件夹中),对该会话中的任何其他单元格都生效。浏览器版无法读取 schema 文件,因此在那里 Protobuf 值始终按字段编号显示。

编辑压缩的值

以压缩格式存储的值——gzip、zlib、原始 deflate、zstd、LZ4(帧或带大小前缀的块),或 MySQL COMPRESS() 输出,可以直接编辑其中的文本,然后以完全相同的压缩方式写回,因此任何读取它的程序都照常工作:

  • 结果网格。 在查看器中打开一个压缩的二进制单元格(以十六进制查看… 或者 打开结构化数据查看器)。当视图内容是解压后的值时, 编辑 会打开文本; 暂存为 gzip (或当初读取它时采用的任何打包方式)会将其重新压缩,并暂存为该单元格的待处理更改,你可以像对待其他任何网格编辑一样查看并保存。
  • Redis 键视图。 编辑压缩字符串、哈希字段或列表元素时,会从其解压后的文本开始,并 重新压缩另存为… 勾选后,审核过的命令将写入重新压缩的字节。取消勾选则按输入文本存储。

打包方式保持完全一致(zlib 头仍是 zlib 头,MySQL 的 4 字节长度前缀会改写为新长度),并且在任何内容写入暂存区之前,会先校验重新压缩后的字节能解压回你的文本。无法确定打包方式、或内容是二进制而非文本的值,不提供编辑。

二进制单元格也会在 单元格详细信息 面板的十六进制视图以及在查看器中打开,因此任何二进制列中的 MessagePack 值都可以以相同方式解码。

MessagePack 解码器把载荷当作不可信输入:数据中的长度值都会对照实际存在的字节做检查,因此被截断或带恶意的载荷会被报告为无法解码,而不是耗尽内存;嵌套超过 128 层也会被拒绝。

对于 Redis 键读取(GET, HGETALL, LRANGE, JSON.GET…),该选择会记住对应的连接、数据库、键和列,并且在重启 SQLly 后仍然有效:无论在哪个标签或行显示,键的值都会以你选择的格式返回。这些选择会被保留在 value-formats.json ,位于 SQLly 的数据文件夹中,最多保存最近选过的 2,000 个键,较早的先被忘掉。文件带有版本号;若其中的格式名称出自当前版本不认识的较新 SQLly,会按 Auto 读取,而不是拒绝整个文件。如果这个文件读不了,SQLly 会保持它原样,在查看器工具栏下方说明情况,并且你的新选择只在本次会话内有效。其他结果单元格会为该查询、行和列记住这一选择,直到 SQLly 退出。选择 Auto 即会忘掉它。超过 1 MB 的值只保留检测到的视图。

SQLly
值查看器的格式选择器:MessagePack 编码的 Redis 值解码为 JSON 树。
值查看器的格式选择器:MessagePack 编码的 Redis 值解码为 JSON 树。