Formatos de valor
funcionalVer un valor como UTF-8, JSON, hexadecimal, MessagePack, Base64, Protobuf, o descomprimido en gzip, zstd y LZ4; tu elección se recuerda para cada clave.
El visor de valores puede mostrar un valor en el formato que elijas en lugar de solo el que detecta. Abre un valor, Abrir valor en una clave de Redis y luego Abrir en el Visor de valores… o Ver como hexadecimal… en su celda de resultado, o Vista previa de la carga útil en el visor de Pub/Sub, y utiliza el Formato menú en la barra de herramientas del visor. El menú está agrupado: primero las vistas simples, luego las codificaciones, después la compresión y al final los serializadores de lenguaje. Los formatos son solo presentación: elijas el que elijas, los bytes almacenados en la clave nunca cambian.
- Auto - la vista detectada (JSON, XML, imagen, geometría o texto). Si ninguna encaja, Auto también mira los primeros bytes y la estructura del valor y reconoce gzip, zstd, LZ4, zlib, serialización de Java, pickle de Python, PHP
serialize, Base64 y Protobuf; lo que encuentre se nombra junto al menú («Auto: gzip → JSON (1.234 → 5.678 bytes)»). Los sondeos estructurales son conservadores a propósito: hay que poder analizar el valor completo, y solo se prueba Base64 con valores de al menos 16 caracteres cuyos bytes decodificados sean algo legible, así que una palabra corriente, un ID hexadecimal o un nombre de clave comouser:42sigue siendo texto. - UTF-8 - los bytes como texto; el UTF-8 no válido se muestra con caracteres de reemplazo y una nota que lo avisa.
- JSON - con formato legible en la vista de árbol; un valor que no es JSON válido conserva su texto en bruto con una nota.
- YAML - resaltado, con la misma capacidad de búsqueda en árbol que tiene JSON; un valor que no es un mapeo o lista YAML conserva su texto en bruto con una nota.
- Markdown - resaltado en modo Bruto y representado (encabezados, listas, tablas, bloques de código, enlaces) en Vista previa modo.
- Hex - el volcado hexadecimal canónico.
- MessagePack - decodificado a JSON para el árbol y el resaltador. Los campos binarios se muestran como
{"$binary": "<hex>"}, las marcas de tiempo estándar como{"$timestamp": "2023-11-14T22:13:20Z"}, otros valores de extensión como{"$ext": {"type": n, "data": "<hex>"}}, y un mapa cuyas claves colisionarían como claves de objetos JSON (un entero1junto a la cadena"1", o una clave repetida) como{"$map": [[key, value], …]}para que no se pierda ninguna entrada. Una carga que no sea MessagePack válido vuelve al volcado hexadecimal con el motivo del decodificador. - Base64 - estándar o para URL, con relleno o sin él, ignorando los saltos de línea. Los bytes decodificados se muestran luego como lo que son: un árbol JSON o XML, texto, una serialización reconocida o un volcado hexadecimal.
- Protobuf - un mensaje de protocol-buffers se recorre sin su esquema, así que cualquier mensaje se puede inspeccionar: los números de campo se vuelven claves, los varints se muestran como números y los campos de ancho fijo muestran su valor como entero y como punto flotante (
{"$fixed64": …, "$double": …}), los campos delimitados por longitud se muestran como texto cuando se leen como texto, como mensaje anidado cuando se recorren como tal, y como{"$bytes": "<hex>"}de lo contrario. Un campo repetido se convierte en un array. Los nombres de los campos necesitan el esquema del mensaje: registra tus.protoarchivos bajo Ajustes › Resultados › Esquemas Protobuf (ver abajo). - gzip - zstd, LZ4, deflate, el valor se descomprime y el resultado se muestra según lo que contenga (JSON y XML muestran su árbol, PHP, Java, pickle y Protobuf su carga decodificada, el texto su texto, y cualquier otra cosa el volcado hexadecimal), con una nota que indica los tamaños antes y después. Por selección solo se desenvuelve una capa: un flujo comprimido dentro de otro flujo comprimido se menciona en la nota, no se vuelve a descomprimir. LZ4 acepta tanto el formato de trama (frame) como un bloque sin procesar con su tamaño original antepuesto; deflate acepta flujos con envoltura zlib y sin procesar. zstd no está disponible en la edición para navegador de SQLly, y el menú lo indica.
- PHP serialize -
serialize()salida decodificada a JSON: las listas se convierten en arrays, los demás arrays en objetos, objetos{"$class": "Name", "$properties": {…}}con los nombres de propiedades protegidas y privadas escritosprotected:nameyprivate:Class:name, referencias{"$ref": n}, y una cadena que no es UTF-8{"$bytes": "<hex>"}. - Serialización de Java - un
ObjectOutputStreamla carga útil se reconoce por su encabezado y se resume: la versión del flujo, las clases que contiene con susserialVersionUID, y las cadenas en él. Los valores de los campos no se decodifican; eso requiere las propias clases. - Python pickle - un pickle de protocolo 2 o posterior se reconoce por su encabezado y se resume: protocolo, recuentos de códigos de operación, las globales (
module.name) que referencia, una muestra de sus cadenas y si termina de forma limpia. El objeto nunca se reconstruye: eso equivaldría a ejecutar las instrucciones del pickle.
Cada decodificador trata el valor como no confiable. La salida descomprimida se limita a 16 MB, y un tráiler de gzip, un encabezado de frame zstd o un prefijo de bloque LZ4 que ya anuncie más que eso se rechaza antes de empezar a descomprimir; un flujo truncado o corrupto se informa como no decodificable, con el motivo del decodificador, y nunca se muestra como salida parcial. El anidamiento de Protobuf y PHP se corta en 128 niveles, cada longitud dentro de un valor se comprueba contra los bytes realmente presentes, y un walker que no pueda contabilizar cada byte rechaza el valor entero.
Protobuf con tus propios esquemas
Bajo Ajustes › Resultados › Esquemas Protobuf, Añadir archivo .proto… registra uno o más .proto archivos (la carpeta de un archivo es donde se buscan sus importse buscan, y el estándar google/protobuf/* los tipos están integrados), y Añadir conjunto de descriptores… registra un conjunto compilado desde
protoc --descriptor_set_out. Cada esquema se lista con sus tipos de mensaje, o con el motivo que da el compilador cuando no se puede leer; Recargar vuelve a leer los archivos cuando los cambias, y Eliminar desregistra uno sin tocar el archivo.
Con un esquema registrado, un valor mostrado como Protobuf obtiene un Mensaje menú junto al menú Formato. Selecciona un tipo de mensaje y el valor se decodifica con nombres de campo reales - mensajes anidados, enumeraciones por nombre, campos repetidos como arreglos, números de 64 bits como números - en el árbol JSON. Los campos que aporta el valor y que el mensaje no define se listan por número en la nota. Si el valor no encaja en absoluto con el mensaje (un campo tiene un wire type incorrecto, o ninguno de sus campos pertenece al mensaje), o el esquema ya no existe, el visor vuelve a la vista por número de campo sin esquema y explica por qué. El tipo de mensaje se recuerda igual que el formato: para una clave de Redis entre reinicios (en protobuf-schemas.json en la carpeta de datos de SQLly), para cualquier otra celda durante la sesión. La edición del navegador no puede leer archivos de esquema, así que allí los valores de Protobuf siempre se muestran por número de campo.
Editar un valor comprimido
Un valor almacenado comprimido: gzip, zlib, deflate crudo, zstd, LZ4 (trama o bloque con prefijo de tamaño) o salida de MySQL, COMPRESS() puede editarse como el texto que contiene y volver a escribirse comprimido exactamente igual, de modo que quien lo lea siga funcionando:
- Cuadrícula de resultados. Abrir una celda binaria comprimida en el visor (Ver como hexadecimal… o Abrir visor de datos estructurados). Cuando la vista es un valor descomprimido, Editar abre el texto; Preparar como gzip (o el formato de empaquetado con el que se leyó) lo vuelve a comprimir y lo deja como cambio pendiente en esa celda, que revisas y guardas como cualquier otra edición de la cuadrícula.
- Vista de claves de Redis. Editar una cadena comprimida, un campo hash o un elemento de lista parte de su texto descomprimido con Guardar recomprimido como … marcado; el comando revisado escribe los bytes recomprimidos. Desmárcalo para almacenar el texto tal como se escribió.
El empaquetado se identifica con exactitud (un encabezado zlib sigue siendo un encabezado zlib; el prefijo de longitud de 4 bytes de MySQL se reescribe para la nueva longitud), y se comprueba que los bytes recomprimidos se descomprimen de nuevo en tu texto antes de preparar nada. Un valor cuyo empaquetado no se pueda identificar, o cuyo contenido sea binario y no texto, no se ofrece para edición.
Las celdas binarias también tienen el selector en el Detalles de la celda vista hexadecimal del panel y en el visor que abre, así que un valor MessagePack en cualquier columna binaria se puede decodificar igual.
El decodificador de MessagePack trata la carga útil como no confiable: las longitudes de los datos se comprueban contra los bytes realmente presentes, así que una carga útil truncada o malintencionada se marca como no decodificable en lugar de agotar la memoria, y se rechaza cualquier anidamiento de más de 128 niveles.
Para una lectura de clave de Redis (GET, HGETALL, LRANGE, JSON.GET…) abierta desde una celda de resultados, la elección se recuerda para esa conexión, base de datos, clave y columna, y sobrevive al reinicio de SQLly: el valor de la clave vuelve en el formato elegido, sin importar qué pestaña o fila lo muestre. Estas opciones se guardan en value-formats.json en la carpeta de datos de SQLly, que guarda las últimas 2000 claves elegidas; las más antiguas se olvidan primero. El archivo lleva un número de versión, y un nombre de formato escrito por una versión más nueva de SQLly que esta no conoce se lee como Auto en lugar de rechazar el archivo. Si no se puede leer, SQLly lo deja intacto, lo avisa bajo la barra de herramientas del visor y conserva tus nuevas elecciones solo para esta sesión. Las demás celdas de resultados recuerdan la elección para esa consulta, fila y columna hasta que se cierre SQLly. Elegir Auto la olvida. Los valores de más de 1 MB conservan solo la vista detectada.
