Сетка
функциональныйЗапишите порядок столбцов, скрытые и замороженные столбцы, сортировку, группировку и фильтры в запрос.
Директива grid записывает в запрос раскладку столбцов сетки результатов: какие столбцы идут первыми, какие скрыты или закреплены, как сортируются, группируются и фильтруются строки и какие внешние ключи показывают читаемую подпись. Всё это возвращается при каждом запуске — для любого, кто откроет файл.
Синтаксис
-- sqlly grid: <setting>; <setting>…
-- sqlly grid <n>: <setting>; <setting>…
Настройки разделяются ;, в любом порядке. Без указания номера строка применяется ко всем наборам результатов выполнения, например lines:. С одним номером, grid 2: применяется только ко второму набору результатов, считая с 1.
| Настройка | Значение | Пример |
|---|---|---|
order=a, b, c | Порядок отображения. Перечисленные столбцы идут первыми, в этом порядке; остальные видимые столбцы следуют в своем естественном порядке. | order=Id, Name, Total |
hide=a, b | Скрыть эти столбцы. | hide=Notes, RowVersion |
freeze=N | Закрепить первые N отображаемых столбцов при горизонтальной прокрутке. | freeze=1 |
sort=col [asc|desc], … | Сортировать по одному или нескольким столбцам. asc является значением по умолчанию. | sort=Total desc, Name |
group=col | Группировать строки по этому столбцу. | group=Region |
filter=col op value | Фильтр по столбцу. Повторите настройку, чтобы фильтровать больше столбцов. | filter=Status is Open |
label=col:display | Метка внешнего ключа: показать display из упомянутой таблицы рядом с col. label=col:off выключает метку. | label=CustomerId:Name |
Операторы фильтрации
A filter= использует те же условия, что и панель фильтров по столбцам в сетке:
| Значения | Операторы | Пример |
|---|---|---|
| Текст | contains, not contains, begins with, ends with, is, is not, matches (регулярное выражение) | filter=Email ends with @example.com |
| Числа и даты | =, !=, >, >=, <, <=, between A and B, not between A and B | filter=Total between 100 and 500 |
| Список значений (флажки панели фильтра) | in A | B | C | filter=Region in West | North |
Имена столбцов
Пишите имя столбца в двойных кавычках, если оно содержит пробел, запятую, точку с запятой или кавычку, и удваивайте кавычку внутри: "Order Date", "Rep ""Ace"" Name".
Примеры
-- sqlly grid: order=Region, Rep, Total; hide=Notes; freeze=1; sort=Total desc, Rep
-- sqlly grid: filter=Region is West; filter=Total > 1000
SELECT Region, Rep, Total, Created, Notes FROM sales;
Два набора результатов, каждый со своей расстановкой:
-- sqlly grid 1: sort="Order Date" desc; label=CustomerId:CompanyName
-- sqlly grid 2: group=Category; hide=Discontinued
SELECT OrderId, CustomerId, OrderDate AS [Order Date] FROM dbo.Orders;
SELECT ProductName, Category, Discontinued FROM dbo.ProductList;
Какая расстановка выигрывает
SQLly уже запоминает, как вы настроили столбцы результата, по таблице или по запросу.
grid: директива имеет приоритет над этим запомненным расположением, поэтому запрос показывает одну и ту же расстановку для всех, кто его выполняет. Ручное изменение сетки пока продолжает работать; директива снова применяется при следующем запуске.
grid: строку, включая ширины и форматы. См. Заблокировать сетку.