Форматы значений
функциональныйПросматривайте значение в формате UTF-8, JSON, hex, MessagePack, Base64, Protobuf или распакованным gzip, zstd и LZ4, при этом ваш выбор сохраняется для каждого ключа.
Просмотрщик значений может показывать значение в выбранном вами формате, а не только в том, который он определил сам. Откройте значение, Открыть значение на ключе Redis, а затем Открыть в просмотрщике значений… или Просмотреть как hex… на его ячейке результата, или Предварительный просмотр данных в просмотрщике Pub/Sub и используйте Формат меню на панели инструментов просмотрщика. Меню сгруппировано: простые представления, затем кодировки, затем сжатие, затем сериализаторы языков. Форматы влияют только на отображение: что бы вы ни выбрали, байты, хранящиеся в ключе, никогда не меняются.
- Авто - обнаруженное представление (JSON, XML, изображение, геометрия или текст). Когда ни одно из них не совпадает, Auto также смотрит на начальные байты и структуру значения и распознает gzip, zstd, LZ4, zlib, сериализацию Java, pickle Python, PHP
serialize, Base64 и Protobuf; то, что распознано, пишется рядом с меню («Авто: gzip → JSON (1,234 → 5,678 байт)»). Структурные проверки намеренно консервативны: значение целиком должно разбираться, а догадка Base64 делается только для значений длиной от 16 символов, у которых декодированные байты — что-то читаемое, поэтому обычное слово, шестнадцатеричный идентификатор или имя ключа вродеuser:42остаётся текстом. - UTF-8 - байты как текст; некорректный UTF-8 отображается с символами замены и заметкой об этом.
- JSON - форматируется с отступами и показывается деревом; значение, не являющееся корректным JSON, остаётся в исходном виде с пометкой.
- YAML - выделяется, с теми же возможностями поиска по дереву, что и JSON; значение, которое не является YAML-мэппингом или списком, сохраняет свой исходный текст с заметкой.
- Markdown - выделяется в режиме Raw и отображается (заголовки, списки, таблицы, блоки кода, ссылки) в режиме Предварительный просмотр режим.
- Hex - канонический шестнадцатеричный дамп.
- MessagePack - декодируется в JSON для дерева и подсветки. Двоичные поля отображаются как
{"$binary": "<hex>"}, стандартные временные метки как{"$timestamp": "2023-11-14T22:13:20Z"}, другие значения расширений как{"$ext": {"type": n, "data": "<hex>"}}, а словарь, ключи которого конфликтовали бы как ключи JSON-объекта (целое число1рядом со строкой"1"или повторяющийся ключ) как{"$map": [[key, value], …]}, чтобы ни одна запись не потерялась. Данные, которые не удалось разобрать как MessagePack, показываются в виде шестнадцатеричного дампа с пояснением от декодера. - Base64 - стандартный или URL-safe, с выравниванием или без, переносы строк игнорируются. Декодированные байты показываются как есть: дерево JSON или XML, текст, распознанная сериализация или шестнадцатеричный дамп.
- Protobuf - сообщение Protocol Buffers разбирается без схемы, так что можно просмотреть любое сообщение: номера полей становятся ключами, varint отображаются как числа, поля фиксированной ширины показывают и целочисленное, и вещественное значения (
{"$fixed64": …, "$double": …}), поля с указанием длины показываются как текст, когда читаются как текст, как вложенное сообщение, когда оно разбирается как сообщение, и как{"$bytes": "<hex>"}в остальных случаях. Повторяющееся поле становится массивом. Для имён полей нужна схема сообщения: зарегистрируйте свои.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 - Pickle протокола 2 или более позднее распознается по заголовку и суммируется: протокол, количество операций, глобальные (
module.name), на которые он ссылается, образец его строк и то, корректно ли он завершается. Объект никогда не собирается заново — это означало бы выполнение инструкций pickle.
Каждый декодер считает значение недоверенным. Выход распаковки ограничен 16 МБ, и gzip-трейлер, заголовок фрейма zstd или префикс блока LZ4, который уже заявляет больше, отклоняется до начала распаковки; усечённый или повреждённый поток помечается как не поддающийся декодированию, с причиной от декодера, и никогда не показывается как частичный вывод. Вложенность Protobuf и PHP останавливается на 128 уровнях, каждая длина внутри значения сверяется с реально присутствующими байтами, а обходчик, который не может учесть каждый байт, отбраковывает значение целиком.
Protobuf со своими схемами
При Настройки › Результаты › Схемы Protobuf, Добавить файл .proto… регистрирует один или несколько .proto файлы (папка файла — это место, где ищутся его import-ы ищутся, а стандартные google/protobuf/* типы встроены), и Добавить набор дескрипторов… регистрирует скомпилированный набор из
protoc --descriptor_set_out. Для каждой схемы указаны её типы сообщений или причина от компилятора, если прочитать её не удалось; Перезагрузить считывает файлы заново после того, как вы их изменяете, и Удалить отменяет регистрацию одного из них, не трогая сам файл.
После регистрации схемы значение, показанное как Protobuf, получает Сообщение меню рядом с меню «Формат». Выберите тип сообщения, и значение будет декодировано с использованием реальных имен полей — вложенные сообщения, перечисления по имени, повторяющиеся поля в виде массивов, 64-битные числа как числа — в дереве JSON. Поля, которые содержит значение, но которые сообщение не определяет, перечислены по номеру в заметке. Если значение совершенно не соответствует сообщению (у поля неправильный тип кодирования, или ни одно из его полей не принадлежит сообщению), или схема была удалена, просмотрщик переключается на просмотр полей по номерам без схемы и указывает причину. Тип сообщения запоминается так же, как формат: для ключа Redis между перезапусками (в protobuf-schemas.json в папке данных SQLly), для любой другой ячейки на сессию. Версия для браузера не может читать файлы схем, поэтому в ней значения Protobuf всегда показываются по номеру поля.
Редактирование сжатого значения
Значение, хранящееся в сжатом виде - gzip, zlib, raw deflate, zstd, LZ4 (фрейм или блок с префиксом размера), или MySQL COMPRESS() вывод можно править как обычный текст и записать обратно с тем же сжатием, так что всё, что этот файл читает, продолжит работать:
- Сетка результатов. Откройте сжатую бинарную ячейку в просмотрщике (Просмотреть как hex… или Открыть просмотрщик структурированных данных). Когда в просмотре открыто распакованное значение, Редактировать открывает текст; Подготовить как gzip (или в какой упаковке оно было считано) повторно сжимает его и подготавливает в этой ячейке как изменение, которое вы проверяете и сохраняете, как любое другое изменение сетки.
- Просмотр ключа Redis. Редактирование сжатой строки, поля хеша или элемента списка начинается с распакованного текста с Сохранить с повторным сжатием как … отмечено; проверенная команда записывает повторно сжатые байты. Снимите отметку, чтобы сохранить текст как набранный.
Упаковка определяется точно (заголовок zlib остаётся заголовком zlib, 4-байтовый префикс длины MySQL перезаписывается под новую длину), и повторно сжатые байты проверяются на то, что они распакуются обратно в ваш текст, прежде чем что-либо будет применено. Значение, чью упаковку не удаётся однозначно определить или чьё содержимое бинарное, а не текстовое, не предлагается к редактированию.
Бинарные ячейки также получают селектор в Детали ячейки шестнадцатеричный вид панели, и в просмотрщике он открывается, так что значение MessagePack в любом бинарном столбце может быть декодировано таким же образом.
Декодер MessagePack обрабатывает полезную нагрузку как ненадежную: длины в данных сверяются с фактически присутствующими байтами, поэтому усеченная или вредоносная полезная нагрузка помечается как недекодируемая, вместо того чтобы исчерпать память, а вложенность глубже 128 уровней отклоняется.
Для чтения ключа Redis (GET, HGETALL, LRANGE, JSON.GET…), открытого из ячейки результата: выбор запоминается для этого соединения, базы данных, ключа и столбца и переживает перезапуск SQLly — значение ключа вернётся в выбранном вами формате, из какой бы вкладки или строки оно ни показывалось. Выбор хранится в value-formats.json в папке данных SQLly, в которой хранятся 2 000 последних выбранных ключей; старые забываются первыми. В файле есть номер версии, и имя формата, записанное более новой версией SQLly, которая этому выпуску неизвестна, читается как Auto, а не заставляет отвергнуть файл. Если файл не удаётся прочитать, SQLly оставляет его нетронутым, сообщает об этом под панелью инструментов просмотрщика и хранит ваши новые настройки только для этой сессии. Другие ячейки результатов запоминают выбор для этого запроса, строки и столбца до выхода из SQLly. Выбор Auto сбрасывает запомненное. Значения больше 1 МБ сохраняют только определённый автоматически вид.
