Formatos de valor
funcionalVisualize um valor como UTF-8, JSON, hexadecimal, MessagePack, Base64, Protobuf, ou gzip, zstd e LZ4 descomprimidos, com a sua escolha lembrada por chave.
O visualizador de valores pode mostrar um valor no formato que você escolher, em vez de apenas no que ele detecta. Abra um valor, Abrir valor em uma chave do Redis e então Abrir no Visualizador de Valores… ou Visualizar como Hexadecimal… em sua célula de resultado, ou Pré-visualizar carga útil no visualizador Pub/Sub, e use o Formato menu na barra de ferramentas do visualizador. O menu é agrupado: as visualizações simples, depois as codificações, depois a compressão, depois os serializadores de linguagem. Os formatos são apenas de apresentação: qualquer que você escolha, os bytes armazenados na chave nunca mudam.
- Automático - a exibição detectada (JSON, XML, imagem, geometria ou texto). Quando nenhuma delas corresponde, o Auto também olha os bytes iniciais e a estrutura do valor e reconhece gzip, zstd, LZ4, zlib, serialização Java, pickle Python, PHP
serialize, Base64 e Protobuf; o que ele encontrou é nomeado ao lado do menu («Auto: gzip → JSON (1.234 → 5.678 bytes)»). As detecções estruturais são conservadoras de propósito: o valor inteiro precisa ser analisável, e um palpite de Base64 só acontece para valores de pelo menos 16 caracteres cujos bytes decodificados sejam algo legível, então uma palavra simples, um ID hexadecimal ou um nome de chave comouser:42permanece como texto. - UTF-8 - os bytes como texto; UTF-8 inválido é exibido com caracteres de substituição e uma nota avisando isso.
- JSON - exibido de forma legível com a visão em árvore; um valor que não é JSON válido mantém o texto original com uma nota.
- YAML - destacado, com a mesma árvore pesquisável que o JSON tem; um valor que não é um mapeamento nem uma lista YAML mantém o texto cru, com uma nota.
- Markdown - destacado no modo Raw e renderizado (títulos, listas, tabelas, blocos de código, links) em Pré-visualização modo.
- Hex - o despejo hexadecimal canônico.
- MessagePack - decodificado para JSON para a árvore e o realce de sintaxe. Campos binários aparecem como
{"$binary": "<hex>"}, timestamps padrão como{"$timestamp": "2023-11-14T22:13:20Z"}, outros valores de extensão como{"$ext": {"type": n, "data": "<hex>"}}, e um mapa cujas chaves colidiriam como chaves de objeto JSON (um inteiro1ao lado da string"1", ou uma chave repetida) como{"$map": [[key, value], …]}para que nenhuma entrada seja perdida. Um payload que não seja um MessagePack válido recai no dump hexadecimal com o motivo do decodificador. - Base64 - padrão ou URL-safe, com ou sem preenchimento, ignorando quebras de linha. Os bytes decodificados são então exibidos como o que forem: uma árvore JSON ou XML, texto, uma serialização reconhecida ou um despejo hexadecimal.
- Protobuf - uma mensagem de protocol-buffers é percorrida sem o esquema dela, então qualquer mensagem pode ser inspecionada: números de campos viram chaves, varints aparecem como números, campos de largura fixa mostram tanto a leitura inteira quanto a de ponto flutuante (
{"$fixed64": …, "$double": …}), campos delimitados por comprimento aparecem como texto quando lidos como texto, como mensagem aninhada quando percorrem como uma, e como{"$bytes": "<hex>"}caso contrário. Um campo repetido torna-se um array. Nomes de campos precisam do esquema da mensagem: registre seus.protoarquivos sob Configurações › Resultados › Esquemas Protobuf (veja abaixo). - gzip - zstd, LZ4, deflate, o valor é descomprimido e o resultado é mostrado como o que ele contém (JSON e XML ganham suas árvores, cargas PHP, Java, pickle e Protobuf ganham sua decodificação, texto ganha seu texto, qualquer outra coisa ganha o dump hexadecimal), com uma nota indicando os tamanhos antes e depois. Só uma camada é desembrulhada a cada escolha: um fluxo comprimido dentro de outro fluxo comprimido é apontado na nota, não descomprimido de novo. LZ4 aceita tanto o formato de frame quanto um bloco cru com o tamanho original na frente; deflate aceita fluxos com wrapper zlib e crus. O zstd não está disponível na edição do SQLly para navegador, e o menu avisa isso.
- PHP serialize -
serialize()saída decodificada para JSON: listas tornam-se arrays, outros arrays objetos, objetos{"$class": "Name", "$properties": {…}}com nomes de propriedade protegida e privada escritosprotected:nameeprivate:Class:name, referências{"$ref": n}, e uma string que não é UTF-8{"$bytes": "<hex>"}. - Serialização Java - um
ObjectOutputStreamcarga útil é reconhecida pelo cabeçalho e resumida: a versão do fluxo, as classes que ela carrega com seusserialVersionUID, e as strings dentro dele. Os valores dos campos não são decodificados; para isso é preciso ter as próprias classes. - Python pickle - um pickle de protocolo 2 ou posterior é reconhecido pelo cabeçalho e resumido: protocolo, contagens de opcodes, os globais (
module.name) que ele referencia, uma amostra de suas strings e se ele termina de forma limpa. O objeto nunca é reconstruído, pois isso significaria executar as instruções do pickle.
Cada decodificador trata o valor como não confiável. A saída descompactada tem um limite de 16 MB, e um trailer gzip, cabeçalho de quadro zstd ou prefixo de bloco LZ4 que já declare mais que isso é recusado antes de qualquer descompactação começar; um fluxo truncado ou corrompido é relatado como não decodificável, com o motivo do decodificador, e nunca mostrado como saída parcial. O aninhamento de Protobuf e PHP para em 128 níveis, cada comprimento dentro de um valor é verificado contra os bytes realmente presentes, e um varredor que não consegue contabilizar cada byte recusa o valor inteiro.
Protobuf com seus próprios esquemas
Em Configurações › Resultados › Esquemas Protobuf, Adicionar arquivo .proto… registra um ou mais .proto arquivos (a pasta de um arquivo é onde seus imports são pesquisados, e os google/protobuf/* os tipos já vêm embutidos), e Adicionar conjunto de descritores… registra um conjunto compilado a partir de
protoc --descriptor_set_out. Cada schema é listado com os tipos de mensagem dele, ou com o motivo apontado pelo compilador quando não dá para ler; Recarregar lê novamente os arquivos depois que você os altera, e Remover remove o registro de um sem tocar no arquivo.
Com um schema registrado, um valor mostrado como Protobuf recebe um Mensagem menu ao lado do menu Formato. Escolha um tipo de mensagem e o valor é decodificado com nomes reais de campos - mensagens aninhadas, enums por nome, campos repetidos como arrays, números de 64 bits como números - na árvore JSON. Campos que o valor possui e que a mensagem não define são listados por número na nota. Se o valor não se encaixa na mensagem de forma alguma (um campo tem o tipo de fio incorreto ou nenhum de seus campos pertence à mensagem), ou o esquema foi removido desde então, o visualizador recorre à visualização sem esquema por número de campo e explica o motivo. O tipo da mensagem é lembrado assim como o formato: para uma chave do Redis entre reinicializações (em protobuf-schemas.json na pasta de dados do SQLly), para qualquer outra célula durante a sessão. A edição do navegador não pode ler arquivos de esquema, então valores Protobuf são sempre exibidos por número de campo.
Editando um valor compactado
Um valor armazenado comprimido - gzip, zlib, deflate puro, zstd, LZ4 (frame ou bloco com prefixo de tamanho), ou MySQL COMPRESS() a saída, pode ser editado como o texto dentro dele e escrito de volta comprimido exatamente da mesma forma, para que qualquer coisa que o leia continue funcionando:
- Grade de resultados. Abra uma célula binária comprimida no visualizador (Visualizar como Hexadecimal… ou Abrir visualizador de dados estruturados). Quando a visualização é um valor descompactado, Editar abre o texto; Preparar como gzip (ou qualquer empacotamento em que tenha sido lido) o recomprime e o prepara como uma alteração pendente na célula, que você revisa e salva como qualquer outra edição de grade.
- Visualização de chaves do Redis. Editar uma string compactada, um campo hash ou um elemento de lista começa pelo texto descompactado com Salvar recompactado como … marcado; o comando revisado grava os bytes recomprimidos. Desmarque-o para armazenar o texto como digitado.
O empacotamento é reproduzido exatamente (um cabeçalho zlib continua um cabeçalho zlib, o prefixo de comprimento de 4 bytes do MySQL é reescrito para o novo comprimento), e os bytes recompactados são verificados para descomprimir de volta ao seu texto antes que qualquer coisa seja preparada. Um valor cujo empacotamento não pode ser determinado, ou cujo conteúdo é binário em vez de texto, não é oferecido para edição.
Células binárias também recebem o seletor no Detalhes da célula na visão hexadecimal do painel e no visualizador que ele abre, então um valor MessagePack em qualquer coluna binária pode ser decodificado da mesma forma.
O decodificador MessagePack trata o conteúdo como não confiável. Os comprimentos nos dados são verificados em relação aos bytes realmente presentes, então um conteúdo truncado ou hostil é relatado como não decodificável em vez de esgotar a memória, e aninhamentos com mais de 128 níveis são recusados.
Para uma leitura de chave Redis (GET, HGETALL, LRANGE, JSON.GET…) aberta a partir de uma célula de resultado, a escolha é lembrada para aquela conexão, banco de dados, chave e coluna, e sobrevive à reinicialização do SQLly: o valor da chave volta no formato que você escolheu, independentemente de qual guia ou linha o exibe. As escolhas são mantidas em value-formats.json na pasta de dados do SQLly, que contém as 2.000 chaves mais recentemente escolhidas; as mais antigas são esquecidas primeiro. O arquivo possui um número de versão e um nome de formato escrito por um SQLly mais recente que este não conhece, e é lido como Auto em vez de recusar o arquivo. Se esse arquivo não puder ser lido, o SQLly o deixa intacto, informa isso na barra de ferramentas do visualizador e mantém suas novas escolhas apenas para esta sessão. Outras células de resultado lembram a escolha para essa consulta, linha e coluna até que o SQLly seja fechado. Escolher Auto faz com que seja esquecido. Valores acima de 1 MB mantêm apenas a visualização detectada.
