畫布

功能性的

當答案並排更容易理解時,自由排列結果窗格。

畫布 把結果集鋪到你用註解定義的網格上。它適合儀表板式的查詢:摘要放在一個位置,明細結果集放在另一個位置;而且因為版面配置就寫在 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 的棋盤,或某個維度為 0 的棋盤會被標記,查詢會把各結果集改成堆疊顯示。
  • 位置註解 後面沒有接會產生結果的陳述式 會被標記——你以為會填進值的儲存格卻空著,通常就是這個緣故。
  • 沒有剩餘的空儲存格 對於某個結果集會準確指出哪一個無法放置,讓你知道需要擴大棋盤。
SQLly
SQLly 畫布結果版面配置SQLly 畫布結果版面配置
一種畫布版面:結果集依 SQL 註解所定義的儲存格排成網格。