Raster

funktional

Schreibe 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.

EinstellungBedeutungBeispiel
order=a, b, cAnzeigereihenfolge. 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, bDiese Spalten ausblenden.hide=Notes, RowVersion
freeze=NDie 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=colZeilen nach dieser Spalte gruppieren.group=Region
filter=col op valueEin Filter pro Spalte. Wiederholen Sie die Einstellung, um weitere Spalten zu filtern.filter=Status is Open
label=col:displayFremdschlü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:

WerteOperatorenBeispiel
Textcontains, 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 Bfilter=Total between 100 and 500
Eine Werteliste (die Checkboxen des Filterbereichs)in A | B | Cfilter=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.

Lass die Sperre es schreiben. Arrangiere das Raster mit der Maus (ziehen, ausblenden, einfrieren, sortieren, filtern), und klicke dann auf das Schloss vor dem Namen des Ergebnisses. SQLly schreibt die passende grid: Zeile, einschließlich der Breiten und Formate. Siehe Raster sperren.