キャンバス
実装済み答えを並べて見たほうが理解しやすいときは、結果ペインを自由に配置できます。
キャンバス は、コメントで定義したグリッドに結果セットを配置します。サマリーを 1 か所に、詳細セットを別の場所に置きたいダッシュボード型のクエリ向けで、レイアウトは SQL の中にあるため、ファイルと一緒に移動します。
グリッドを宣言する
1 つのディレクティブでボードのサイズを設定し、 rows × columns。続いて、各配置ディレクティブは 上記 ステートメントの上に置かれ、セルを次のように確保します
row|column、いずれも 1 始まり:
-- sqlly 2x2
-- sqlly result: 1|1
SELECT ...; -- top-left cell
-- sqlly result: 1|2
SELECT ...; -- next cell across
セルの結合(スパン)
次のどちら側でも | 範囲を指定できるため、結果セットが1つのブロックを占めることができます。4列のボードの上部全体に広いサマリーを置き、その下に詳細を配置する例:
-- sqlly 2x4
-- sqlly result: 1|1-4
SELECT ...; -- full-width banner row
-- sqlly result: 2|1-2
SELECT ...; -- bottom-left half
すべてを置く必要はありません
配置指定のないステートメントや、ステートメントが返す余分な結果セットは、左から右、上から下の順にスキャンされ、次の空きセルに自動配置されます。そのため、重要な 2 つの結果セットだけを配置し、残りは自動で収まるようにできます。
ボードがうまくいかないとき
SQLly は、何かを黙って勝手に処理するのではなく、レイアウトの問題を報告します。SQL から判別できる問題は、エディターで問題のあるディレクティブまたはステートメントに下線が表示されます。クエリの実行時にはじめてセルが 1 つもないと分かった結果セットは、キャンバスボードの下のメモに一覧表示されます。クエリのうち、最初の非空行に -- sqlly RxC 行が最初の空でない行にあるスクリプトは、代わりに結果セットを縦に積んで表示します。
- A 不正な配置 - 次ではない
row|column、正の整数ではない、または開始より前で終わる範囲)は報告され、その結果セットは代わりに自動配置されます。 - A セルが2回指定されています、または宣言されたグリッドの外側への配置は警告され、その結果セットは代わりに自動配置されます。
- 8×8 より大きい盤面、またはいずれかの次元が 0 の盤面にはフラグが付き、クエリは結果セットを積み重ねて表示します。
- 配置コメントが 結果を返すステートメントが続いていません は警告されます。入力されるはずのセルが空のままになる、よくある原因です。
- 空きセルは残っていません 結果セットについては、配置できなかったものを正確に示すので、ボードを大きくすればよいと分かります。

