Raster
funktionalSchreibe die Spaltenreihenfolge, ausgeblendete und eingefrorene Spalten, Sortierung, Gruppierung und Filter in die Abfrage.
Die Raster-Direktive schreibt die Spaltenanordnung des Ergebnisrasters in die Abfrage: welche Spalten zuerst kommen, welche ausgeblendet oder eingefroren sind, wie Zeilen sortiert, gruppiert und gefiltert werden und welche Fremdschlüssel ein lesbares Label zeigen. Sie kommt bei jedem Lauf zurück, für alle, die die Datei öffnen.
Syntax
-- sqlly grid: <setting>; <setting>…
-- sqlly grid <n>: <setting>; <setting>…
Einstellungen sind getrennt durch ;, in beliebiger Reihenfolge. Ohne eine Zahl gilt die Zeile für jeden Ergebnissatz des Laufs, wie lines:. Mit einem, grid 2: gilt nur für die zweite Ergebnismenge, gezählt ab 1.
| Einstellung | Bedeutung | Beispiel |
|---|---|---|
order=a, b, c | Anzeigereihenfolge. Die aufgeführten Spalten kommen zuerst, in dieser Reihenfolge; die anderen sichtbaren Spalten folgen in ihrer natürlichen Reihenfolge. | order=Id, Name, Total |
hide=a, b | Diese Spalten ausblenden. | hide=Notes, RowVersion |
freeze=N | Die ersten N angezeigten Spalten fixieren, während du seitlich scrollst. | freeze=1 |
sort=col [asc|desc], … | Nach einer oder mehreren Spalten sortieren. asc ist die Standardeinstellung. | sort=Total desc, Name |
group=col | Zeilen nach dieser Spalte gruppieren. | group=Region |
filter=col op value | Ein Filter pro Spalte. Wiederholen Sie die Einstellung, um weitere Spalten zu filtern. | filter=Status is Open |
label=col:display | Fremdschlüssel-Beschriftung: anzeigen display aus der referenzierten Tabelle neben col. label=col:off blendet das Label aus. | label=CustomerId:Name |
Filteroperatoren
A filter= verwendet dieselben Bedingungen wie der Spaltenfilter-Bereich des Rasters:
| Werte | Operatoren | Beispiel |
|---|---|---|
| Text | contains, not contains, begins with, ends with, is, is not, matches (ein regulärer Ausdruck) | filter=Email ends with @example.com |
| Zahlen und Datumsangaben | =, !=, >, >=, <, <=, between A and B, not between A and B | filter=Total between 100 and 500 |
| Eine Werteliste (die Checkboxen des Filterbereichs) | in A | B | C | filter=Region in West | North |
Spaltennamen
Schreibe einen Spaltennamen in doppelte Anführungszeichen, wenn er ein Leerzeichen, ein Komma, ein Semikolon oder ein Anführungszeichen enthält, und verdopple ein Anführungszeichen darin: "Order Date", "Rep ""Ace"" Name".
Beispiele
-- 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;
Zwei Ergebnismengen, jeweils mit eigener Anordnung:
-- 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;
Welche Anordnung gewinnt
SQLLY merkt sich bereits, wie du die Spalten eines Ergebnisses hinterlassen hast, pro Tabelle oder pro Abfrage. Ein
grid: Direktive hat Vorrang vor diesem gespeicherten Layout, sodass die Abfrage für jeden, der sie ausführt, dieselbe Anordnung zeigt. Das manuelle Ändern des Rasters funktioniert vorerst noch; die Direktive greift beim nächsten Durchlauf wieder.
grid: Zeile, einschließlich der Breiten und Formate. Siehe Raster sperren.