グリッド
実装済み列の順序、非表示列と固定列、ソート、グループ化、フィルターをクエリに書き込みます。
grid ディレクティブは、結果グリッドの列の並びをクエリに書き込みます。どの列を先頭に置くか、どれを非表示や固定にするか、行をどう並べ替え、グループ化し、絞り込むか、どの外部キーに読みやすいラベルを表示するか、といった内容です。ファイルを開く人の誰に対しても、実行のたびにこの設定が復元されます。
構文
-- sqlly grid: <setting>; <setting>…
-- sqlly grid <n>: <setting>; <setting>…
設定は次の文字で区切ります ;、順序は問いません。番号がない場合、その行は実行のすべての結果セットに適用されます。たとえば lines:。1 つの場合、 grid 2: 2番目の結果セットにのみ適用されます(1から数えます)。
| 設定 | 意味 | 例 |
|---|---|---|
order=a, b, c | 表示順。一覧にある列がこの順で先頭に並び、そのほかの表示中の列が通常の順序で続きます。 | order=Id, Name, Total |
hide=a, b | これらの列を非表示にします。 | hide=Notes, RowVersion |
freeze=N | 横スクロール中も、最初の N 個の表示列を固定します。 | freeze=1 |
sort=col [asc|desc], … | 1 つ以上の列で並べ替えます。 asc はデフォルトです。 | sort=Total desc, Name |
group=col | この列で行をグループ化します。 | group=Region |
filter=col op value | 列ごとのフィルターです。この設定を繰り返すと、複数の列を絞り込めます。 | filter=Status is Open |
label=col:display | 外部キーラベル: 表示 display 参照先のテーブルから、次の横に col. label=col:off ラベルをオフにします。 | label=CustomerId:Name |
フィルター演算子
A filter= グリッドの列ごとのフィルターパネルと同じ条件を使用します:
| 値 | オペレーター | 例 |
|---|---|---|
| テキスト | contains, not contains, begins with, ends with, is, is not, matches (正規表現) | filter=Email ends with @example.com |
| 数字と日付 | =, !=, >, >=, <, <=, between A and B, not between A and B | filter=Total between 100 and 500 |
| 値のリスト(フィルターパネルのチェックボックス) | in A | B | C | filter=Region in West | North |
列名
列名にスペース、カンマ、セミコロン、引用符が含まれる場合は二重引用符で囲み、内部の引用符は 2 つ重ねます: "Order Date", "Rep ""Ace"" Name".
例
-- sqlly grid: order=Region, Rep, Total; hide=Notes; freeze=1; sort=Total desc, Rep
-- sqlly grid: filter=Region is West; filter=Total > 1000
SELECT Region, Rep, Total, Created, Notes FROM sales;
2 つの結果セット。それぞれ独自の配置になっています:
-- sqlly grid 1: sort="Order Date" desc; label=CustomerId:CompanyName
-- sqlly grid 2: group=Category; hide=Discontinued
SELECT OrderId, CustomerId, OrderDate AS [Order Date] FROM dbo.Orders;
SELECT ProductName, Category, Discontinued FROM dbo.ProductList;
どの配置が優先されるか
SQLly は、結果の列をどのような状態にしていたかを、テーブルごとまたはクエリごとに、すでに記憶しています。
grid: ディレクティブは、その記憶されたレイアウトより優先されるため、クエリを実行する誰にとっても同じ配置で表示されます。グリッドを手で変更することは、その場では引き続き可能で、ディレクティブは次回の実行時に再び適用されます。
ロックに書かせる。 マウス (ドラッグ、非表示、固定、並べ替え、フィルター) でグリッドを整え、結果名の前にあるロックをクリックします。SQLly は一致する
grid: 行。幅と書式も含みます。参照: グリッドをロックする.