网格

功能的

将列顺序、隐藏和冻结列、排序、分组以及筛选写入查询。

网格指令会把结果网格的列布局写入查询:哪些列排在前面、哪些被隐藏或冻结、行如何排序、分组和筛选,以及哪些外键显示易读的标签。每次运行都会恢复,任何打开该文件的人都能看到。

语法

-- 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: 行,宽度和格式也会一并写入。参见 锁定网格.