Сетка

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

Запишите порядок столбцов, скрытые и замороженные столбцы, сортировку, группировку и фильтры в запрос.

Директива 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 Bfilter=Total between 100 and 500
Список значений (флажки панели фильтра)in A | B | Cfilter=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: директива имеет приоритет над этим запомненным расположением, поэтому запрос показывает одну и ту же расстановку для всех, кто его выполняет. Ручное изменение сетки пока продолжает работать; директива снова применяется при следующем запуске.

Пусть блокировка выполнит запись. Упорядочьте сетку с помощью мыши (перетаскивание, скрытие, закрепление, сортировка, фильтрация), затем нажмите замок перед названием результата. SQLly записывает соответствующую grid: строку, включая ширины и форматы. См. Заблокировать сетку.