Просмотрщик ячеек JSON и XML

функциональный

Открывайте ячейки JSON или XML как аккуратные, удобные для изучения структуры вместо стены знаков препинания.

Столбец, содержащий документ JSON или XML, нечитаем в строке сетки: он отображается одной длинной строкой, выходящей за границы ячейки. SQLly распознаёт, когда значение на самом деле является документом, и предоставляет для него подходящий просмотрщик.

Как распознается ячейка

Обнаружение анализирует ячейку сырое значение - реальные данные, до форматирования отображения или маскирования столбцов — и без опоры на объявленный тип столбца. Значение считается документом, если оно и начинается как надо, и разбирается без ошибок:

  • JSON - обрезанное значение начинается с { или [ и разбирается как корректный JSON.
  • XML - обрезанное значение начинается с < и разбирается как корректный XML.
  • YAML - значение начинается с --- маркер документа или содержит как минимум два элемента верхнего уровня key: value строки плюс дополнительная структура (третий ключ, вложенный блок или элемент списка), каждая строка верхнего уровня выглядит как YAML, и разбирается. Предложение с двоеточием внутри или заметка в две строки остаются просто текстом.
  • Markdown - как минимум две строки с блоком кода в тройных обратных кавычках, таблицей или двумя разными видами разметки Markdown (заголовки, списки, цитаты, ссылки, жирный текст, код в строке). Одиночный заголовок или короткий список остаются текстом.

Требование успешного разбора намеренное: строка, которая просто начинается с фигурной скобки, остаётся нетронутой, а не предлагается как документ, который нельзя открыть. Вот почему nvarchar столбец, содержащий JSON, распознаётся, тогда как настоящий json столбец с некорректным текстом не распознаётся.

Открытие просмотрщика

  • Щёлкните правой кнопкой мыши › Открыть просмотрщик структурированных данных. Доступно всегда, и это же путь для двоичных и геометрических ячеек. (А двойной щелчок по ячейке копирует её значение.)
  • Панель сведений о ячейке. Показывает тот же просмотрщик встроенно для выбранной ячейки, так что вы можете перемещаться по сетке с открытым рядом документом. Откройте его через контекстное меню ячейки (Редактировать ячейку › Сведения о ячейке), с ⌘⌥I (CtrlAltI на Windows и Linux), или через палитру команд (Переключить панель деталей ячейки). Закрепить оставляет его на одной ячейке, пока вы перемещаетесь.

Внутри просмотрщика

  • Красиво отформатировано. При загрузке документ приводится к единому отступу. Ключи объектов JSON отсортированы, поэтому один и тот же документ всегда читается одинаково, и две строки можно сравнивать построчно.
  • Подсветка синтаксиса в режиме Raw — прокручиваемый просмотр отформатированного текста.
  • Древовидный режим - сворачиваемые узлы с живым поиском и копированием по узлу, для поиска одного поля в слишком длинном для прокрутки документе. JSON, XML и YAML поддерживают это.
  • Режим предварительного просмотра для Markdown, текст отрисовывается с заголовками, списками, таблицами и блоками кода; переключитесь на Raw для подсвеченного исходника.
Копировать с красивым форматированием есть и в контекстном меню ячейки, в разделе Копировать как, когда вы хотите получить отформатированный текст в буфере обмена, не открывая ничего.

Редактирование значения в панели сведений о ячейке

Когда результат можно редактировать — запрос к одной таблице с ключом, на соединении, допускающем изменения — в представлении Value на панели есть Редактировать кнопку. Она открывает просторный многострочный редактор ячейки, что гораздо удобнее, чем ввод длинного описания или JSON-документа в ячейку сетки.

  • Применить (или ⌘Enter, CtrlEnter на Windows и Linux) этапы новое значение точно так же, как любое другое редактирование в сетке: строка получает маркер подготовленного изменения, и ничего не записывается, пока вы не просмотрите и Сохранить (или отбросьте) подготовленные изменения. Esc или Отмена выбрасывает черновик.
  • NULL и пустое значение — разные вещи. Применение пустого редактора устанавливает пустую строку; Установить NULL устанавливает NULL.
  • Значение проверяется на соответствие своему столбцу так же, как редактор строки проверяет поле (целое число для целочисленного столбца, допустимая дата для столбца даты и так далее); если оно не подходит, строка состояния сообщает причину, а ваш черновик остаётся открытым. Для json или jsonb столбца текст, который не является допустимым JSON, всё равно остаётся в черновике, с предупреждением под редактором.
  • Длинные значения сначала загружаются полностью. Ячейку, которая была получена как сокращённый предварительный просмотр, нельзя редактировать, пока панель не загрузит полное значение.
  • Когда редактирование невозможно панель объясняет причину вместо кнопки «Редактировать»: например, запрос по нескольким таблицам, соединение только для чтения, замаскированный или вычисляемый столбец либо двоичное значение (изменить их можно через Загрузить из файла или шестнадцатеричный просмотрщик).
  • Закреплённые панели редактировать закреплённую ячейку, даже когда вы уже перешли дальше по сетке.

Другие типы содержимого ячеек

Тот же просмотрщик обрабатывает всё остальное, что не помещается в ячейку сетки: изображения (PNG, JPEG, GIF, WebP, BMP распознаются по магическим байтам и отображаются) двоичный (показывается как hex-дамп с ASCII-колонкой), и геометрия значения.