網格
功能性的把欄位順序、隱藏與凍結的欄位、排序、分組和篩選都寫進查詢。
網格指示詞會把結果網格的欄位排列寫進查詢:哪些欄位排在前面、哪些隱藏或凍結、資料列如何排序、分組與篩選,以及哪些外部索引鍵顯示可讀標籤。每次執行都會自動套回,任何開啟這個檔案的人都看得到。
語法
-- sqlly grid: <setting>; <setting>…
-- sqlly grid <n>: <setting>; <setting>…
各項設定以 ;,順序不限。沒有編號時,該行適用於該執行的每個結果集,例如 lines:。有編號時, grid 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], … | 按一個或多個欄位排序。 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 |
欄位名稱
欄位名稱若含空格、逗號、分號或引號,就用雙引號括住,並將內部的引號寫兩次: "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;
兩個結果集,各有各的排列方式:
-- 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: 行,寬度和格式也一併寫好。請參見 鎖定網格.