Formats de valeurs
fonctionnelAffichez une valeur en UTF-8, JSON, hexadécimal, MessagePack, Base64, Protobuf, ou en gzip, zstd et LZ4 décompressés, avec votre choix mémorisé par clé.
Le visualiseur de valeur peut afficher une valeur dans le format que vous choisissez au lieu de seulement celui qu'il détecte. Ouvrez une valeur, Ouvrir la valeur sur une clé Redis, puis Ouvrir dans le visualiseur de valeurs… ou Afficher en Hex… sur sa cellule de résultat, ou Aperçu de la charge utile dans le visualiseur Pub/Sub, et utilisez le Format menu dans la barre d'outils du visualiseur. Le menu est regroupé : les vues simples, puis les encodages, ensuite la compression, puis les sérialiseurs de langage. Les formats sont seulement pour la présentation : quel que soit votre choix, les octets stockés dans la clé ne changent jamais.
- Automatique - la vue détectée (JSON, XML, image, géométrie ou texte). Lorsqu'aucune de celles-ci ne correspond, Auto examine également les octets initiaux et la structure de la valeur et reconnaît gzip, zstd, LZ4, zlib, la sérialisation Java, le pickle Python, PHP
serialize, Base64, et Protobuf ; ce qu'il a trouvé est indiqué à côté du menu (« Auto : gzip → JSON (1 234 → 5 678 octets) »). Les détections structurelles sont intentionnellement conservatrices : la valeur entière doit être analysable, et une supposition Base64 n’est faite que pour des valeurs d’au moins 16 caractères dont les octets décodés sont lisibles, donc un mot simple, un identifiant hexadécimal, ou un nom de clé commeuser:42reste du texte. - UTF-8 - les octets en tant que texte ; l’UTF-8 invalide est affiché avec des caractères de remplacement et une note l’indiquant.
- JSON - joliment formaté avec la vue en arbre ; une valeur qui n’est pas un JSON valide conserve son texte brut avec une note.
- YAML - mis en évidence, avec le même arbre à recherche que JSON ; une valeur qui n'est ni un mappage ni une liste YAML conserve son texte brut avec une note.
- Markdown - mis en évidence en mode brut, et rendu (titres, listes, tableaux, blocs de code, liens) en Aperçu mode.
- Hexa - le dump hexadécimal canonique.
- MessagePack - décodé en JSON pour l'arborescence et la coloration syntaxique. Les champs binaires apparaissent comme
{"$binary": "<hex>"}, les horodatages standards comme{"$timestamp": "2023-11-14T22:13:20Z"}, les autres valeurs d'extension comme{"$ext": {"type": n, "data": "<hex>"}}, et une map dont les clés entreraient en collision en tant que clés d'objet JSON (un entier1à côté de la chaîne"1", ou une clé répétée) comme{"$map": [[key, value], …]}afin qu'aucune entrée ne soit perdue. Une charge utile qui n'est pas un MessagePack valide revient au dump hexadécimal avec la raison du décodeur. - Base64 - standard ou compatible URL, avec ou sans remplissage, en ignorant les retours à la ligne. Les octets décodés sont ensuite affichés pour ce qu'ils sont : un arbre JSON ou XML, du texte, une sérialisation reconnue, ou un dump hexadécimal.
- Protobuf - un message protocol-buffers parcouru sans son schéma, de sorte que n'importe quel message peut être inspecté : les numéros de champ deviennent des clés, les varints s'affichent comme des nombres, les champs à largeur fixe montrent à la fois leurs valeurs entières et flottantes (
{"$fixed64": …, "$double": …}), les champs à longueur délimitée s'affichent comme du texte lorsqu'ils sont lisibles en tant que texte, comme un message imbriqué lorsqu'ils se parcourent ainsi, et comme{"$bytes": "<hex>"}autrement. Un champ répété devient un tableau. Les noms des champs nécessitent le schéma du message : enregistrez vos.protofichiers sous Paramètres › Résultats › Schémas Protobuf (voir ci-dessous). - gzip - zstd, LZ4, deflate, la valeur est décompressée et le résultat est affiché tel quel (JSON et XML affichent leur arbre, les charges utiles PHP, Java, pickle et Protobuf sont décodées, le texte reste du texte, et tout le reste sous forme de dump hexadécimal), avec une note indiquant les tailles avant et après. Une seule couche est retirée à chaque opération : un flux compressé à l'intérieur d'un flux compressé est nommé dans la note, sans être décompressé à nouveau. LZ4 accepte aussi bien le format de trame qu'un bloc brut avec sa taille d'origine en préfixe ; deflate accepte les flux enveloppés zlib et les flux bruts. zstd n'est pas disponible dans l'édition navigateur de SQLly, et le menu l'indique.
- PHP serialize -
serialize()sortie décodée en JSON : les listes deviennent des tableaux, les autres tableaux des objets, les objets{"$class": "Name", "$properties": {…}}avec les noms de propriétés protégées et privées orthographiésprotected:nameetprivate:Class:name, références{"$ref": n}, et une chaîne qui n'est pas UTF-8{"$bytes": "<hex>"}. - Sérialisation Java - un
ObjectOutputStreamla charge utile est reconnue par son en-tête et résumée : la version du flux, les classes qu'elle contient avec leursserialVersionUID, et les chaînes qu'elle contient. Les valeurs des champs ne sont pas décodées ; cela nécessite les classes elles-mêmes. - Pickle Python - un pickle de protocole 2 ou plus est reconnu par son en-tête et résumé : protocole, comptage des opcodes, les globals (
module.name) il référence, un échantillon de ses chaînes, et si cela se termine correctement. L'objet n'est jamais reconstruit, cela impliquerait d'exécuter les instructions du pickle.
Chaque décodeur traite la valeur comme non fiable. La sortie décompressée est plafonnée à 16 Mo, et un trailer gzip, un en-tête de trame zstd ou un préfixe de bloc LZ4 qui annonce déjà plus que cela est refusé avant le début de toute décompression ; un flux tronqué ou corrompu est signalé comme non décodable, avec la raison donnée par le décodeur, jamais comme sortie partielle. L'imbrication Protobuf et PHP s'arrête à 128 niveaux, chaque longueur à l'intérieur d'une valeur est vérifiée par rapport aux octets réellement présents, et un parcours qui ne peut pas rendre compte de chaque octet refuse la valeur entière.
Protobuf avec vos propres schémas
Sous Paramètres › Résultats › Schémas Protobuf, Ajouter un fichier .proto… enregistre un ou plusieurs .proto fichiers (le dossier d'un fichier est l'endroit où ses imports sont consultés, et les types google/protobuf/* standards sont intégrés), et Ajouter un ensemble de descripteurs… enregistre un ensemble compilé depuis
protoc --descriptor_set_out. Chaque schéma est listé avec ses types de messages, ou avec la raison du compilateur quand il ne peut pas être lu ; Recharger relit les fichiers après que vous les avez modifiés, et Supprimer désinscrit l'un sans toucher au fichier.
Avec un schéma enregistré, une valeur affichée comme Protobuf obtient un Message menu à côté du menu Format. Choisissez un type de message et la valeur est décodée avec les noms de champs réels - messages imbriqués, énumérations par nom, champs répétés sous forme de tableaux, nombres 64 bits en tant que nombres - dans l'arborescence JSON. Les champs que la valeur contient, mais que le message ne définit pas, sont listés par numéro dans la note. Si la valeur ne correspond pas du tout au message (un champ a le mauvais type de fil, ou aucun de ses champs n'appartient au message), ou si le schéma a depuis été supprimé, le visualiseur revient à la vue sans schéma par numéro de champ et indique pourquoi. Le type de message est mémorisé comme le format : pour une clé Redis entre les redémarrages (dans protobuf-schemas.json dans le dossier de données de SQLly), pour toute autre cellule pendant la session. L'édition navigateur ne peut pas lire les fichiers de schéma, donc là, les valeurs Protobuf sont toujours affichées par numéro de champ.
Édition d'une valeur compressée
Une valeur stockée compressée - gzip, zlib, deflate brut, zstd, LZ4 (trame ou bloc préfixé par la taille), ou MySQL COMPRESS() la sortie, peut être éditée comme le texte qu'elle contient et réécrite compressée exactement de la même manière, afin que tout ce qui la lit continue de fonctionner :
- Grille de résultats. Ouvrir une cellule binaire compressée dans le visualiseur (Afficher en Hex… ou Ouvrir le visualiseur de données structurées). Lorsque la vue est une valeur décompressée, Modifier ouvre le texte ; Mettre en attente en tant que gzip (ou quel que soit le format dans lequel elle a été lue) la recompresse et la place comme modification en attente sur cette cellule, que vous examinez puis enregistrez comme toute autre édition de grille.
- Vue de clé Redis. La modification d'une chaîne compressée, d'un champ de hachage ou d'un élément de liste commence à partir de son texte décompressé avec Enregistrer recompressé sous … coché ; la commande examinée écrit les octets recompressés. Décochez-le pour stocker le texte tel qu'il est saisi.
Le format d'encapsulation est reproduit exactement (un en-tête zlib reste un en-tête zlib, le préfixe de longueur de 4 octets de MySQL est réécrit pour la nouvelle longueur), et les octets recompressés sont vérifiés pour se décompresser à nouveau en votre texte avant que quoi que ce soit ne soit mis en attente. Une valeur dont le format d'encapsulation ne peut pas être déterminé, ou dont le contenu est binaire plutôt que du texte, n'est pas proposée pour modification.
Les cellules binaires obtiennent également le sélecteur dans le Détails de la cellule la vue hexadécimale du panneau et dans le visualiseur qu'il ouvre, si bien qu'une valeur MessagePack dans n'importe quelle colonne binaire peut être décodée de la même manière.
Le décodeur MessagePack traite la charge utile comme non fiable. Les longueurs des données sont vérifiées par rapport aux octets réellement présents, donc une charge utile tronquée ou hostile est signalée comme indécodable au lieu d'épuiser la mémoire, et un niveau de profondeur supérieur à 128 est refusé.
Pour une lecture de clé Redis (GET, HGETALL, LRANGE, JSON.GET…) ouverte depuis une cellule de résultat, le choix est mémorisé pour cette connexion, cette base de données, cette clé et cette colonne, et il survit au redémarrage de SQLly : la valeur de la clé revient dans le format que vous avez choisi, quel que soit l'onglet ou la ligne qui l'affiche. Les choix sont conservés dans value-formats.json dans le dossier de données de SQLly, qui contient les 2 000 clés les plus récemment choisies ; les plus anciennes sont oubliées en premier. Le fichier porte un numéro de version, et un nom de format écrit par une version plus récente de SQLly mais inconnu de celle-ci est lu comme Auto plutôt que de refuser le fichier. Si ce fichier ne peut pas être lu, SQLly le laisse intact, l'indique sous la barre d'outils du visualiseur et garde vos nouveaux choix pour cette session uniquement. Les autres cellules de résultat retiennent le choix pour cette requête, ligne et colonne jusqu'à ce que SQLly se ferme. Choisir Auto l'oublie. Les valeurs de plus de 1 Mo ne gardent que la vue détectée.
