锁定网格
功能的一键就能把结果按当前看到的样子写进查询,这样每次运行得到的都一样。
按你想要的方式排列结果:拖动列、隐藏部分列、设置宽度、排序、筛选、着色、透视或绘图,然后点击 锁。SQLly 会把当前看到的结果原样写成 SQLly 指令存入查询。下次运行时,或者同事打开同一个文件时,得到的都是同样的网格。
锁的位置
每个结果集名称前都会有一个小锁图标:
- 标签页布局 - 在结果标签页的标题上。
- 堆叠布局 - 在卡片标题上。
- 画布布局 - 在单元格标题上。
当查询已经包含锁块时,该图标会被高亮显示。


它写入的内容
在已执行语句的顶部有一个块注释,其中包含 -- sqlly 结果的每个部分各有一行:
/* sqlly lock — SQLly wrote this from the result grid; click the lock on the result to refresh it.
-- sqlly view: pivot
-- sqlly layout: tabbed
-- sqlly grid: order=Region, Rep, Total, Created; hide=Notes; freeze=1; sort=Total desc, Rep; filter=Region is West
-- sqlly format: column=Total; number=2; width=40dp
-- sqlly format: column=Rep; width=60dp
-- sqlly conditional: column=Total; when=> 10000; fill=#E3F4E8; text=#1E7B34; bold
-- sqlly conditional: column=Total; bar=#5B9BD5
-- sqlly pivot: row:Region; column:Year; value:Total:sum
-- sqlly chart: kind:bar; label:Region; values:Total
*/
SELECT Region, Rep, Total, Created, Notes FROM sales;
该块会捕获:
| 你看到的是 | 写成 |
|---|---|
| 列顺序、隐藏列与冻结列、排序、分组、列筛选以及外键标签 | grid: |
| 每列格式、舍入和列宽 | format: |
| 结果列的条件格式规则 | conditional: |
| 计算列及其公式 | column: |
| 数据透视表和图表配置 | pivot: 和 chart: |
| 打开的是哪个视图:网格、透视表还是图表 | view: |
| 结果布局:堆叠、标签页或画布 | layout: |
| 哪个结果拥有焦点、结果名称,以及堆叠式的行数分配 | focus:, name,以及 lines: |
宽度以 dp,一个跟随网格字号的单位,这样无论同事屏幕上的字号更大还是更小,一列能显示的字符数都大致相同。
再次点击
- 该块始终与屏幕匹配。 在更改网格后再次点击锁,SQLly 会重写该块以匹配当前屏幕上的内容。
- 外面的任何东西都无法推翻它。 锁写入的那类指令,若出现在所运行代码的其他位置,比如一条
grid:或者format:比如你手写的行,也都会被并入该块中。 - 一次撤销。 每次点击都是一次编辑,所以 ⌘Z (CtrlZ 在 Windows 和 Linux 上)会将查询恢复。
它故意省略的内容
- 掩码显示。 短暂显示被掩码的列并不会被记录,因此绝不会为下一个读取者解除数据掩码。
- 参数和变量。
param:和set行会留在你原来写下的位置。 - 画布位置。
result:单元格和画布大小(2x2)会保持你编写时的原样。 - “筛选行…”可处理列筛选无法表达的条件。 使用 将现有筛选条件加入 WHERE 以便将这些保留在 SQL 中。
- 设置 › 结果列覆盖。 这些本就全局适用,因此不会被复制到查询中。
手动编辑块
该块是普通文本。在以 /* sqlly lock,其中每一
-- sqlly 行的效果与它单独占一行时完全相同,并且块里的第一条指令行会算作查询的第一行,用于 view:。开头行必须以 /* sqlly lock,而块会终止在一个只包含
*/。任何其他块注释仍会使里面的指令失效,这是临时禁用几行的好办法。