Wertformate

funktional

Sieh dir einen Wert als UTF-8, JSON, Hex, MessagePack, Base64, Protobuf oder dekomprimiertes gzip, zstd und LZ4 an, und deine Wahl wird pro Schlüssel gemerkt.

Der Wertbetrachter kann einen Wert im Format deiner Wahl anzeigen statt nur im erkannten. Öffne einen Wert, Wert öffnen auf einem Redis-Schlüssel und dann Im Werte-Viewer öffnen… oder Als Hex anzeigen… auf seiner Ergebniszelle, oder Vorschau Nutzlast im Pub/Sub-Betrachter, und verwende das Format Menü in der Symbolleiste des Viewers. Das Menü ist gruppiert: zuerst die einfachen Ansichten, dann Kodierungen, dann Kompression, dann Sprachserialisierer. Die Formate sind rein zur Darstellung: Welches du auch wählst, die im Schlüssel gespeicherten Bytes ändern sich nie.

  • Automatisch - die erkannte Ansicht (JSON, XML, Bild, Geometrie oder Text). Wenn keine dieser Optionen zutrifft, schaut Auto auch auf die führenden Bytes und die Struktur des Wertes und erkennt gzip, zstd, LZ4, zlib, Java-Serialisierung, Python-Pickle, PHP serialize, Base64 und Protobuf; was gefunden wurde, wird neben dem Menü angezeigt („Auto: gzip → JSON (1,234 → 5,678 Bytes)“). Die strukturellen Prüfungen sind absichtlich konservativ: Der ganze Wert muss sich parsen lassen, und eine Base64-Vermutung gibt es nur für Werte ab 16 Zeichen, deren dekodierte Bytes etwas Lesbares ergeben, somit bleibt ein einfaches Wort, eine Hex-ID oder ein Schlüsselname wie user:42 bleibt Text.
  • UTF-8 - die Bytes als Text; ungültiges UTF-8 wird mit Ersatzzeichen und einem Hinweis darauf angezeigt.
  • JSON - schön formatiert mit der Baumansicht; ein Wert, der kein gültiges JSON ist, behält seinen Rohtext mit einem Hinweis.
  • YAML - hervorgehoben, mit demselben durchsuchbaren Baum, den auch JSON bekommt; ein Wert, der weder ein YAML-Mapping noch eine Liste ist, behält seinen Rohtext mit einem Hinweis.
  • Markdown - hervorgehoben im Rohmodus und gerendert (Überschriften, Listen, Tabellen, Codeblöcke, Links) im Vorschau Modus.
  • Hex - der kanonische Hexdump.
  • MessagePack - in JSON für den Baum und den Highlighter dekodiert. Binärfelder werden als {"$binary": "<hex>"}angezeigt, Standard-Zeitstempel als {"$timestamp": "2023-11-14T22:13:20Z"}, andere Erweiterungswerte als {"$ext": {"type": n, "data": "<hex>"}}, und eine Map, deren Schlüssel als JSON-Objektschlüssel kollidieren würden (eine Ganzzahl 1 neben dem String "1"oder ein wiederholter Schlüssel), als {"$map": [[key, value], …]} sodass kein Eintrag verloren geht. Eine Nutzlast, die kein gültiges MessagePack ist, fällt mit der Begründung des Decoders auf den Hex-Dump zurück.
  • Base64 - Standard oder URL-sicher, mit oder ohne Padding, Zeilenumbrüche werden ignoriert. Die decodierten Bytes werden dann so angezeigt, wie sie sind: als JSON- oder XML-Baum, Text, erkannte Serialisierung oder Hex-Dump.
  • Protobuf - eine Protocol-Buffers-Nachricht, die ohne ihr Schema durchlaufen wird, sodass sich jede Nachricht inspizieren lässt: Feldnummern werden zu Schlüsseln, Varints erscheinen als Zahlen, Felder fester Breite zeigen ihre Ganzzahl- und ihre Gleitkomma-Lesart ({"$fixed64": …, "$double": …}), längengebundene Felder werden als Text angezeigt, wenn sie als Text gelesen werden, als verschachtelte Nachricht, wenn sie so durchlaufen werden, und als {"$bytes": "<hex>"} ansonsten. Ein wiederholtes Feld wird zu einem Array. Feldnamen brauchen das Schema der Nachricht: Registriere deine .proto Dateien unter Einstellungen › Ergebnisse › Protobuf-Schemas (siehe unten).
  • gzip - zstd, LZ4, deflate, der Wert wird dekomprimiert und das Ergebnis wird als das angezeigt, was er enthält (JSON und XML zeigen ihre Bäume, PHP, Java, Pickle und Protobuf-Payloads ihre Dekodierung, Text seinen Text, alles andere als Hex-Dump), mit einem Hinweis auf die Größen vor und nach der Dekompression. Pro Auswahl wird nur eine Ebene entpackt: ein komprimierter Stream innerhalb eines komprimierten Streams wird im Hinweis benannt, nicht erneut dekomprimiert. LZ4 akzeptiert sowohl das Frame-Format als auch einen Rohblock mit vorangestellter Originalgröße; deflate akzeptiert zlib-verpackte und rohe Streams. zstd ist in der Browser-Ausgabe von SQLly nicht verfügbar, und das Menü weist darauf hin.
  • PHP serialize - serialize() Ausgabe in JSON dekodiert: Listen werden zu Arrays, andere Arrays zu Objekten, Objekte zu {"$class": "Name", "$properties": {…}} mit geschützten und privaten Eigenschaftsnamen geschrieben protected:name und private:Class:name, Referenzen {"$ref": n}, und eine Zeichenkette, die nicht UTF-8 ist {"$bytes": "<hex>"}.
  • Java-Serialisierung - ein ObjectOutputStream Nutzlast wird am Header erkannt und zusammengefasst: die Stream-Version, die Klassen, die sie trägt, mit ihren serialVersionUID, und die darin enthaltenen Zeichenketten. Feldwerte werden nicht decodiert; das braucht die Klassen selbst.
  • Python-Pickle - ein Pickle mit Protokoll 2 oder höher wird an seinem Header erkannt und zusammengefasst: Protokoll, Opcode-Zähler, die Globals (module.name) es verweist, eine Stichprobe seiner Strings und ob es sauber endet. Das Objekt wird nie neu aufgebaut, das würde bedeuten, die Anweisungen des Pickles auszuführen.

Jeder Decoder behandelt den Wert als nicht vertrauenswürdig. Die dekomprimierte Ausgabe ist auf 16 MB begrenzt, und ein Gzip-Trailer, Zstd-Frame-Header oder LZ4-Block-Präfix, das bereits mehr beansprucht, wird abgelehnt, bevor irgendeine Dekomprimierung beginnt; ein abgeschnittener oder beschädigter Stream wird mit dem Grund des Decoders als nicht dekodierbar gemeldet, niemals als Teilausgabe angezeigt. Protobuf und PHP-Nesting stoppen bei 128 Ebenen, jede Länge innerhalb eines Wertes wird gegen die tatsächlich vorhandenen Bytes geprüft, und ein Walker, der nicht für jedes Byte Rechenschaft ablegen kann, lehnt den gesamten Wert ab.

Protobuf mit eigenen Schemas

Unter Einstellungen › Ergebnisse › Protobuf-Schemas, .proto-Datei hinzufügen… registriert einen oder mehrere .proto Dateien (der Ordner einer Datei ist der Ort, an dem ihre importgesucht werden, und die standard google/protobuf/* typen sind eingebaut), und Descriptor-Set hinzufügen… registriert ein kompiliertes Set von protoc --descriptor_set_out. Jedes Schema wird mit seinen Nachrichtentypen aufgelistet, oder mit der Begründung des Compilers, wenn es sich nicht lesen lässt; Neu laden liest die Dateien neu, nachdem du sie geändert hast, und Entfernen meldet eines ab, ohne die Datei anzufassen.

Mit einem registrierten Schema erhält ein als Protobuf angezeigter Wert ein Nachricht Menü neben dem Format-Menü. Wähle einen Nachrichtentyp aus, und der Wert wird mit echten Feldnamen dekodiert - verschachtelte Nachrichten, Enums mit Namen, wiederholte Felder als Arrays, 64-Bit-Zahlen als Zahlen - im JSON-Baum. Felder, die der Wert enthält, die die Nachricht aber nicht definiert, werden in der Notiz nach Nummer aufgeführt. Wenn der Wert gar nicht zur Nachricht passt (ein Feld hat den falschen Wire-Typ oder keines seiner Felder gehört zur Nachricht) oder das Schema inzwischen entfernt wurde, fällt der Viewer auf die schemafreie Feldnummer-Ansicht zurück und sagt warum. Der Nachrichtentyp wird wie das Format gemerkt: für einen Redis-Schlüssel über Neustarts hinweg (in protobuf-schemas.json im SQLly-Datenordner), für jede andere Zelle während der Sitzung. Die Browser-Version kann keine Schemadateien lesen, daher werden Protobuf-Werte dort immer nach Feldnummer angezeigt.

Bearbeiten eines komprimierten Wertes

Ein komprimiert gespeicherter Wert - gzip, zlib, raw deflate, zstd, LZ4 (Frame oder Block mit vorangestellter Größe) oder MySQL COMPRESS() Ausgabe, kann wie der Text darin bearbeitet und exakt auf dieselbe Weise wieder komprimiert zurückgeschrieben werden, sodass alles, was ihn liest, weiterhin funktioniert:

  • Ergebnisraster. Öffne eine komprimierte Binärzelle im Viewer (Als Hex anzeigen… oder Strukturierten Daten-Viewer öffnen). Wenn die Ansicht ein dekomprimierter Wert ist, Bearbeiten öffnet den Text; Als gzip vormerken (oder in welchem Format es auch immer gelesen wurde) komprimiert es erneut und merkt es als ausstehende Änderung an dieser Zelle vor, die du überprüfst und wie jede andere Rasterbearbeitung speicherst.
  • Redis-Schlüsselansicht. Das Bearbeiten eines komprimierten Strings, Hash-Felds oder Listenelements beginnt beim dekomprimierten Text, mit Neu komprimiert speichern als … angekreuzt; der geprüfte Befehl schreibt die erneut komprimierten Bytes. Häkchen entfernen, um den Text so zu speichern, wie er eingegeben wurde.

Die Verpackung wird exakt nachgebaut (ein zlib-Header bleibt ein zlib-Header, MySQLs 4-Byte-Längenpräfix wird für die neue Länge neu geschrieben), und die neu komprimierten Bytes werden darauf geprüft, dass sie sich zurück zu deinem Text dekomprimieren lassen, bevor irgendetwas übernommen wird. Ein Wert, dessen Verpackung sich nicht eindeutig bestimmen lässt oder dessen Inhalt binär statt Text ist, wird gar nicht erst zum Bearbeiten angeboten.

Binäre Zellen erhalten auch den Auswähler im Zellendetails Hex-Ansicht des Panels und in dem Viewer, der sich dabei öffnet, sodass sich ein MessagePack-Wert in jeder Binärspalte genauso dekodieren lässt.

Der MessagePack-Decoder behandelt den Payload als nicht vertrauenswürdig. Längen in den Daten werden gegen die tatsächlich vorhandenen Bytes geprüft, sodass ein abgeschnittener oder bösartiger Payload als nicht dekodierbar gemeldet wird, statt den Speicher zu erschöpfen; tiefer als 128 Ebenen verschachtelt wird abgelehnt.

Beim Lesen eines Redis-Schlüssels (GET, HGETALL, LRANGE, JSON.GET…) aus einer Ergebniszelle geöffnet wird, merkt sich SQLly die Auswahl für diese Verbindung, Datenbank, Schlüssel und Spalte — auch über einen Neustart von SQLly hinweg: Der Wert des Schlüssels kommt in dem Format zurück, das du gewählt hast, egal welcher Tab oder welche Zeile ihn anzeigt. Die Auswahlen landen in value-formats.json im SQLly-Datenordner, der die 2.000 zuletzt gewählten Schlüssel enthält; ältere werden zuerst vergessen. Die Datei trägt eine Versionsnummer, und ein Formatname, den ein neueres SQLly geschrieben hat und dieses nicht kennt, wird als Auto gelesen, statt die Datei zurückzuweisen. Wenn sich die Datei nicht lesen lässt, lässt SQLly sie unangetastet, sagt das unter der Viewer-Symbolleiste und behält deine neue Auswahl nur für diese Sitzung. Andere Ergebniszellen merken sich die Auswahl für diese Abfrage, Zeile und Spalte, bis SQLly beendet wird. Die Wahl von Auto vergisst sie. Werte über 1 MB behalten nur die erkannte Ansicht.

SQLly
Format-Auswahl des Werte-Viewers: ein MessagePack-codierter Redis-Wert, der in den JSON-Baum dekodiert wird.
Format-Auswahl des Werte-Viewers: ein MessagePack-codierter Redis-Wert, der in den JSON-Baum dekodiert wird.