画布

功能的

并排更容易看懂答案时,可以自由排列结果窗格。

画布 会把多个结果集铺到你用注释定义的网格上。它适用于仪表盘式的查询:汇总放在一个位置,明细结果集放在另一个位置;由于布局就写在 SQL 里,它也会随文件一起走。

声明网格

一条指令即可设定画板大小, rows × columns。随后,每个放置指令都会写入 以上 语句的上方,并把一个单元格认领为 row|column,两者都从 1 开始计数:

-- sqlly 2x2

-- sqlly result: 1|1
SELECT ...;   -- top-left cell

-- sqlly result: 1|2
SELECT ...;   -- next cell across

跨单元格

两边的 | 可以是一个范围,因此一个结果集可以占用一个区块。四列看板顶部横贯一条宽汇总,细节显示在下方:

-- sqlly 2x4

-- sqlly result: 1|1-4
SELECT ...;   -- full-width banner row

-- sqlly result: 2|1-2
SELECT ...;   -- bottom-left half

你不必放置所有内容

没有指定位置的语句,以及语句返回的多余结果集,都会自动放入下一个空单元格,按从左到右、从上到下的顺序扫描。所以你只需摆好重要的那两个结果集,其余的自动归位。

当画布行不通时

SQLly 会报告布局问题,而不是默默地进行任意处理。在 SQL 里就能看出的问题,会在编辑器中把出错的指令或语句标上下划线;查询跑起来后才发现没有单元格的结果集,则会列在画布板下方的备注里。查询如果在其第一个非空行上没有 -- sqlly RxC 行,它的结果集就会改为堆叠显示。

  • A 位置错误 - 不是 row|column,不是正整数,或者范围的结尾早于开头——都会被报告出来,该结果集会改为自动放置。
  • A 单元格被声明了两次,或者声明网格之外的位置——都会被标记,对应结果集会改为自动放置。
  • 棋盘大于 8×8 或某一维度为零时会被标记,查询会将其结果集堆叠显示。
  • 放置注释 后面没有跟会产生结果集的语句 会被标记出来——你以为会填充的单元格却空着,通常就是这个原因。
  • 没有剩余空位 针对该结果集的提示会准确说明是哪一个结果没放下,你就知道该把画布调大了。
SQLly
SQLly 画布结果布局SQLly 画布结果布局
画布布局:将结果集排列成由 SQL 注释定义的单元格网格。