Форматирование
функциональныйСделайте числа, даты, идентификаторы и текст проще для восприятия, не изменяя данные под ними.
Форматирование превращает набор результатов в ответ, а не в сырую выгрузку данных. SQLly отталкивается от типа столбца, а дальше вы задаёте значения по умолчанию или делаете осознанное исключение для конкретного столбца. Оба пути ведут к одной и той же модели форматирования:
- Типовые настройки. Открыть Настройки › Результаты чтобы выбрать, как каждый тип отображается в SQLly.
- Переопределение по столбцу. Щелкните правой кнопкой мыши на заголовке и выберите Формат › Переопределить форматирование…. SQLly записывает
-- sqlly format:директиву в запрос, чтобы выбор сохранялся вместе с файлом.
Числовые и временные типы также имеют опцию выравнивания (слева, по центру или справа), поэтому не нужно повторять это на каждой странице ниже. Числа по умолчанию выровнены по правому краю, чтобы цифры выстраивались в столбик; даты — по левому.
Как SQLly выбирает тип
Объявленный тип каждого столбца определяет, какое значение по умолчанию применяется. Помечать столбцы самому не нужно — SQLly читает тип, который база данных сообщает для результата:
| Объявленный тип (примеры) | Отформатировано как |
|---|---|
int, bigint, smallint, tinyint, serial, int4, UInt64, MySQL year | Целое число |
decimal, numeric, money, float, real, double, Oracle number | Десятичное число |
datetime, datetime2, datetimeoffset, timestamp, timestamptz, date, time | Даты |
uniqueidentifier, uuid | UUID |
Всё остальное - varchar, nvarchar, text, json… | Текст в исходном виде - см. Строка для параметров каждого столбца |
Числовые столбцы форматируются, даже когда драйвер возвращает их как текст — SQL Server
decimal и money значения, как и любое значение в текстовых протоколах PostgreSQL и MySQL, приходят именно так и читаются обратно как числа для отображения.
Быстрый выбор из заголовка
Установить переопределение формата… предлагает короткий список, который соответствует типу столбца, плюс Пользовательский форматировщик… для шаблонов, путей JSON и стилей чисел:
| Тип столбца | Варианты |
|---|---|
Целое число (int, bigint, smallint, tinyint, serial) | Разделители тысяч, Простое целое число, Секунды эпохи → дата/время, Миллисекунды эпохи → дата/время |
Десятичное / с плавающей запятой (decimal, numeric, money, float, real, double) | 2, 4 или 6 десятичных знаков, Без группировки |
| Дата / время | Дата (2026-07-14), Дата и время, Дата, время и смещение |
| Булев | истина / ложь, Да / Нет, 1 / 0 |
| Бинарный | Шестнадцатеричный, Base64 |
| Текст, UUID и любой тип, не указанный выше | Оригинальный текст, ЗАГЛАВНЫЕ, строчные, Маска (показать последние 4), Маска всего |
Выбор одного варианта добавляет одну строку комментария над запросом. Повторный выбор для того же столбца заменяет эту строку, а не добавляет вторую:
-- sqlly format: column=OrderID; number=0; thousands=false
-- sqlly format: column=Freight; number=2; thousands=true
SELECT OrderID, CustomerID, Freight
FROM dbo.Orders
WHERE Freight > 100;
Какое правило побеждает
- Директива в запросе перебивает всё остальное для этого столбца. Имена столбцов в директивах сравниваются без учёта регистра.
- Настройки › Результаты › Переопределения столбцов содержит настройки отдельных столбцов, которые применяются в каждом запросе, полезно для столбца вроде
card_numberкоторый всегда должен маскироваться. Переопределение задаётся поcolumnчтобы совпадал любой столбец результата с таким именем, или поtable.column(илиschema.table.column) чтобы соответствовать только столбцу этой таблицы. Квалифицированный ключ применяется, когда SQLly может определить, из какой таблицы пришёл столбец результата, — источник тот же, что в подсказке заголовка столбца, — или когда запрос читает всего одну таблицу, — и такой ключ важнее ключа с простым именем для того же столбца. - Типы по умолчанию применяются ко всем остальным столбцам.
Ключ с простым именем должен точно совпадать с именем столбца результата. Квалифицированный ключ сопоставляется без учёта регистра, и его последняя часть может быть именем столбца таблицы или именем, которое столбцу даёт результат, так что orders.total соответствует обоим SELECT o.total и SELECT o.total AS order_total. Когда результат содержит два столбца с одинаковым именем из разных таблиц (SELECT o.id, c.id), квалифицированный ключ, который совпадает только с одним из них, не применяется; задайте псевдоним одному из столбцов, чтобы их различить.
Цвета по типу данных и цвета синтаксиса
Два опциональных переключателя в Настройки › Результаты › Общие добавьте цвет, не создавая правил:
- Окрашивать ячейки по типу данных окрашивает текст, числа, даты и время, булевы значения, уникальные идентификаторы и двоичные значения, каждый — своим цветом. Под переключателем у каждого вида есть Заполнить и Текст селектор цвета; выбранные вами цвета используются как в светлой, так и в тёмной теме, и Сбросить к теме возвращаются к оттенку темы. Ваши правила условного форматирования по-прежнему имеют приоритет, а маскированные столбцы никогда не окрашиваются.
- Подсветка синтаксиса структурированных значений в ячейках подсвечивает JSON и XML внутри сетки — ключи, строки, числа,
true/false/null, теги, атрибуты и комментарии — с синтаксическими цветами вашей темы. Это охватывает столбцы JSON и XML, а также текстовые значения, которые выглядят как JSON или XML. Подсвечивается только видимая часть каждой ячейки, поэтому очень большие документы остаются быстрыми; там, где он задан, цвет текста условного форматирования имеет приоритет.
Значение с переносами строк отображается в сетке на одной строке, с ⏎ где каждый разрыв; копирование, экспорт и редактор ячеек сохраняют реальные переносы строк.
Только отображение
1,234,567.89 копируется как
1234567.89 (или с каждой цифрой, которую отправила база данных). Единственное исключение — маскирование: при Применять форматирование масок к копиям и экспорту включена (по умолчанию), маски из переопределений столбцов, правил конфиденциальных столбцов и mask= переносятся в копии и экспорты. См. маскирование и
экспорт.
NULL не прогоняется через форматирование и всегда отображается как курсивный NULL в сетке.
В этом разделе
- Целое число
- Выберите группировку, знак и единицы, чтобы целые числа было легко читать.
- Десятичное число
- Выберите количество десятичных знаков, группировку и вид отрицательных чисел, чтобы дробные значения легко читались.
- Даты
- Читайте даты по-своему: выберите шаблон и часовой пояс или преобразуйте числа эпохи в реальные даты.
- UUID
- Длинные идентификаторы остаются узнаваемыми и не занимают всю сетку.
- Строка
- Меняйте регистр, обрезайте значения, применяйте шаблоны или извлекайте пути JSON, чтобы текстовые столбцы оставались информативными с первого взгляда.