キャンバス

実装済み

答えを並べて見たほうが理解しやすいときは、結果ペインを自由に配置できます。

キャンバス は、コメントで定義したグリッドに結果セットを配置します。サマリーを 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 の盤面にはフラグが付き、クエリは結果セットを積み重ねて表示します。
  • 配置コメントが 結果を返すステートメントが続いていません は警告されます。入力されるはずのセルが空のままになる、よくある原因です。
  • 空きセルは残っていません 結果セットについては、配置できなかったものを正確に示すので、ボードを大きくすればよいと分かります。
SQLly
SQLly キャンバス結果レイアウトSQLly キャンバス結果レイアウト
キャンバスレイアウト:結果セットを、SQL コメントで定義したセルのグリッドに配置したもの。