Форматирование

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

Сделайте числа, даты, идентификаторы и текст проще для восприятия, не изменяя данные под ними.

Форматирование превращает набор результатов в ответ, а не в сырую выгрузку данных. SQLly отталкивается от типа столбца, а дальше вы задаёте значения по умолчанию или делаете осознанное исключение для конкретного столбца. Оба пути ведут к одной и той же модели форматирования:

  1. Типовые настройки. Открыть Настройки › Результаты чтобы выбрать, как каждый тип отображается в SQLly.
  2. Переопределение по столбцу. Щелкните правой кнопкой мыши на заголовке и выберите Формат › Переопределить форматирование…. 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, uuidUUID
Всё остальное - 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, чтобы текстовые столбцы оставались информативными с первого взгляда.