グリッド

実装済み

列の順序、非表示列と固定列、ソート、グループ化、フィルターをクエリに書き込みます。

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 Bfilter=Total between 100 and 500
値のリスト(フィルターパネルのチェックボックス)in A | B | Cfilter=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: 行。幅と書式も含みます。参照: グリッドをロックする.