Строка
функциональныйМеняйте регистр, обрезайте значения, применяйте шаблоны или извлекайте пути JSON, чтобы текстовые столбцы оставались информативными с первого взгляда.
Текст показывается в том виде, в каком сохранён, — без панели единых настроек по умолчанию. Когда столбцу нужна помощь, щёлкните правой кнопкой мыши по его заголовку и выберите Формат › Переопределить форматирование…. Для текстовых столбцов быстрый список предлагает Исходный текст,
Верхний регистр, Строчные буквы, Скрыть (показать последние 4), и Скрыть все. Пользовательский форматировщик…
открывает селектор: расширенные опции разложены по трём вкладкам, в каждой — живой предпросмотр. Что бы вы ни выбрали, оно записывается в запрос как
-- sqlly format:
строку.


Шаблон
Используйте {value} заполнитель с конвейерными помощниками для изменения регистра, усечения, дополнения и других небольших корректировок, которые делают текст легче читаемым:
| Хелпер | Эффект |
|---|---|
upper / lower | Изменяет регистр. |
trunc:N | Усекать до N символов, добавляя многоточие. |
prefix:S / suffix:S | Добавлять в начало / в конец произвольный текст. |
pad:N | Дополнить слева пробелами до ширины N. |
default:S | Подставлять S, если значение пустое. |
Хелперы выполняются слева направо, а текст вне фигурных скобок сохраняется как написано:
| Значение | Шаблон | Сетка показывает |
|---|---|---|
ada | {value|upper} | ADA |
abcdef | {value|trunc:3} | abc… |
123 | ORD-{value|pad:6} | ORD- 123 |
12 | {value|prefix:$|suffix: USD} | $12 USD |
| (пустая строка) | {value|default:n/a} | n/a |
- NULL остаётся NULL. Шаблоны полностью пропускают NULL-ячейки, поэтому
default:заполняет только пустые строки. - Литеральные фигурные скобки записываются удвоенными:
{{и}}. - Опечатка проявляется. Неизвестный хелпер оставляет заполнитель видимым в исходном виде, например
{value|nope}, вместо того чтобы тихо удалять текст. - Без точек с запятой. Директива разделяется точкой с запятой, поэтому селектор не примет шаблон, содержащий
;.
-- sqlly format: column=code; template={value|upper}
-- sqlly format: column=notes; template={value|trunc:40}
JSON-путь
Извлекает из текстовой колонки JSON нужное значение, например $.customer.name
или $.items[0]. Пути используют сегменты с точками, [n] индексы и ключи в кавычках для имён с пробелами ($["first name"]). Для
payload из
{"customer":{"name":"Ada"},"items":[{"sku":"A1"},{"sku":"B2"}]}:
| Путь | Сетка показывает |
|---|---|
$.customer.name | Ada |
$.items[1].sku | B2 |
$.items[0] | {"sku":"A1"} |
$.missing | (пусто) |
Строки отображаются без кавычек; числа, true/false, и
null показываются как есть; объекты и массивы показываются как компактный JSON. Если путь не находится или ячейка — не корректный JSON, ячейка остаётся пустой либо показывает ваш запасной текст, если вы настроили столбец в Настройки › Результаты › Переопределения столбцов, где есть поле Если отсутствует . Копирование и экспорт сохраняют полный JSON; чтобы исследовать весь документ, откройте
Просмотрщик ячеек JSON и XML.
Число
Примените числовое оформление с выбранными десятичными знаками и разделением тысяч:
| Стиль | Значение | Сетка показывает (2 десятичных знака) |
|---|---|---|
| Исправлено | 1234567.891 | 1,234,567.89 |
Процент (×100, добавляет %) | 0.1234 | 12.34% |
| Байты (B / KiB / MiB / GiB / TiB, шагами по 1024) | 1536 | 1.50 KiB |
| Байты | 512 | 512 B |
Процент и байты работают с любым столбцом, значения которого читаются как числа, — включая числа, сохранённые как текст, например varchar размера. Значения, которые не являются числами, остаются неизменными. Fixed сохраняется как обычное number= правило, поэтому оно применяется к числовым столбцам. Стиль Bytes всегда показывает целые байты меньше 1 KiB и игнорирует группировку тысяч.
-- sqlly format: column=size_bytes; number=2; style=bytes; thousands=true
-- sqlly format: column=hit_rate; number=1; style=percent; thousands=true
SELECT name, size_bytes, hit_rate FROM cache_stats;
Одно правило на столбец
У каждого столбца одно правило форматирования. Повторный выбор для того же столбца заменяет его строку в запросе; если две строки вручную называют один и тот же столбец, побеждает последняя. Так что шаблон и числовой формат нельзя комбинировать на одном столбце.
Связано: конфиденциальный текст может быть скрыт с помощью mask= переопределение. mask= директива, как переопределение маски в Настройки › Результаты › Переопределения столбцов, маскирует сетку, а также копирует и экспортирует данные, пока Применять форматирование масок к копиям и экспорту включено. Все остальные форматы здесь изменяют только отображение сетки - см. маскирование.