グリッドをロックする
実装済みワンクリックで、現在表示されているとおりの結果がクエリに書き込まれるため、実行のたびに同じ結果が返ります。
結果を好きなように整えます。列のドラッグ、いくつかの列の非表示、幅の設定、並べ替え、フィルター、色付け、ピボット、グラフ化を行ってから、次をクリックします ロック。SQLly は、現在見えているとおりの結果を、SQLly ディレクティブとしてクエリに書き込みます。次回の実行、または同じファイルを開いたチームメイトにも、同じグリッドが表示されます。
ロックの場所
すべての結果セット名の前には小さな鍵アイコンが表示されます:
- タブ表示レイアウト - 結果のタブラベル上。
- スタックレイアウト - カードヘッダー上。
- キャンバスのレイアウト - セルヘッダー上。
クエリにすでにロックブロックがある場合、アイコンが強調表示されます。


書き込む内容
実行されたステートメントの先頭に置かれる 1 つのブロックコメントで、次を保持します -- sqlly 結果の各部分につき 1 行:
/* 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:たとえば手で書いた行も、ブロックに取り込まれます。 - 元に戻すのは 1 回で済みます。 クリック 1 回が 1 回の編集なので、 ⌘Z (CtrlZ Windows と Linux では) クエリが元に戻ります。
意図的に省いているもの
- マスクされた値の表示操作。 マスクされた列を一時的に表示してもその操作は記録されないため、ロックがかかっていても次に読む人にデータがマスク解除されて見えることはありません。
- パラメーターと変数。
param:そしてset行は、書いた場所にそのまま残ります。 - キャンバス上の配置。
result:セルとキャンバスサイズ(2x2)は書いたとおりのまま残ります。 - 「行をフィルター…」では、列フィルターでは表現できない条件を指定できます。 使用 アクティブなフィルターを WHERE に追加 それらを代わりに SQL 内に保持するには。
- 設定 › 結果の列オーバーライド。 これらはすべての場所で既に適用されているため、クエリにはコピーされません。
ブロックを手で編集する
ブロックは通常のテキストです。次で始まるコメントの中では /* sqlly lock、それぞれ
-- sqlly 行は、独立した行に書いた場合とまったく同じように動作し、ブロックの最初のディレクティブ行は、クエリの先頭行として次の目的で数えられます view:。開始行は次で始まる必要があります /* sqlly lock、ブロックは次だけが書かれた行で終わります
*/。それ以外のブロックコメントは、その内側のディレクティブを引き続き無効にします。数行を一時的に無効にするのに便利な方法です。