Просмотрщик ячеек 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-колонкой), и геометрия значения.