值格式

功能性的

以 UTF-8、JSON、十六進位、MessagePack、Base64、Protobuf,或解壓縮後的 gzip、zstd 和 LZ4 來檢視值,並會記住每個鍵的選擇。

值檢視器能以你選擇的格式顯示值,而不只是它偵測到的那一種。開啟某個值後, 開啟值 在 Redis 鍵上,然後 在值檢視器中開啟… 或 以十六進位檢視… 在它的結果儲存格上,或者 預覽 Payload 在 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 - 在原始模式下會醒目標示,並算繪(標題、清單、表格、程式碼區塊、連結)於 預覽 模式。
  • 十六進位 - 標準的十六進位傾印。
  • MessagePack - 解碼為 JSON,用於樹狀圖和語法高亮。二進位欄位顯示為 {"$binary": "<hex>"},標準時間戳記顯示為 {"$timestamp": "2023-11-14T22:13:20Z"},其他擴充值顯示為 {"$ext": {"type": n, "data": "<hex>"}},以及轉成 JSON 時鍵值會互相衝突的 map(一個整數 1 緊鄰字串 "1",或是開啟了 {"$map": [[key, value], …]} 這樣就不會遺失任何項目。不符合 MessagePack 格式的負載會退回十六進位傾印,並附上解碼器給出的原因。
  • Base64 - 支援標準或 URL 安全格式,有無補位都可以,換行一律忽略。解碼後的位元組會按其本來身分顯示:JSON 或 XML 樹、純文字、可辨識的序列化格式,或十六進位傾印。
  • Protobuf - 一個在沒有 schema 的情況下走訪的 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 的值就會有 訊息 選單,就在「格式」選單旁邊。挑一個訊息類型,值就會以真正的欄位名稱解碼 - 巢狀訊息、以名稱顯示的列舉、重複欄位變成陣列、64 位元數字變成數字 - 在 JSON 樹中呈現。值有帶但訊息未定義的欄位,會在備註中按編號列出。如果值完全不符合訊息(某個欄位的線路類型不對,或它的欄位都不屬於這個訊息),或者結構描述已經被移除,檢視器就會退回無結構描述的欄位編號檢視,並說明原因。訊息類型會像格式一樣被記住:Redis 鍵的話,重新啟動後也記得(在 protobuf-schemas.json 位於 SQLly 的資料夾中),供該工作階段中的任何其他儲存格使用。瀏覽器版無法讀取結構描述檔,因此 Protobuf 值一律以欄位編號顯示。

編輯壓縮的值

以壓縮格式儲存的值——gzip、zlib、原始 deflate、zstd、LZ4(frame 或 size-prefixed block),或 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,會當作「自動」讀取,而不是拒絕整個檔案。如果檔案無法讀取,SQLly 會保持它不動、在檢視器工具列下方說明,並且只為這個工作階段保留你的新選擇。其他結果儲存格會記住該查詢、列與欄的選擇,直到 SQLly 結束為止;選擇「自動」就會忘掉。超過 1 MB 的值只保留偵測到的檢視。

SQLly
值檢視器格式選擇器:MessagePack 編碼的 Redis 值解碼為 JSON 樹。
值檢視器格式選擇器:MessagePack 編碼的 Redis 值解碼為 JSON 樹。