网格
功能的将列顺序、隐藏和冻结列、排序、分组以及筛选写入查询。
网格指令会把结果网格的列布局写入查询:哪些列排在前面、哪些被隐藏或冻结、行如何排序、分组和筛选,以及哪些外键显示易读的标签。每次运行都会恢复,任何打开该文件的人都能看到。
语法
-- 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: 指令优先于记住的布局,因此任何人运行这条查询,看到的都是同样的排列。手动调整网格暂时仍然有效;但下次运行时指令会再次生效。
让锁来写。 用鼠标整理网格(拖动、隐藏、冻结、排序、筛选),然后点击结果名称前的锁。SQLly 会写入匹配的
grid: 行,宽度和格式也会一并写入。参见 锁定网格.