SQLly-Direktiven
funktionalKleine SQL-Kommentare, die sich merken, wie ein Ergebnis aussieht: seine Spalten, Breiten, Formate, Farben, Pivot und Diagramm.
A Direktive ist ein gewöhnlicher SQL-Kommentar, den SQLly versteht. Für die Datenbank ist er nur ein Kommentar, während SQLly ihn nutzt, um das Ergebnis zu formen oder zu formatieren. Weil Direktiven im Abfragetext stehen, wandern sie mit der Datei mit und greifen jedes Mal wieder, wenn du die Abfrage ausführst.
Jede Direktive teilt denselben Namensraum - das Wort sqlly nach dem Kommentarzeichen:
-- sqlly view: pivot
-- sqlly grid: order=Region, Year, Sales; freeze=1; sort=Sales desc
-- sqlly pivot: row:Region; column:Year; value:Sales:sum
-- sqlly chart: kind:bar; label:Region; values:Sales
-- sqlly format: column=Sales; number=2; width=40dp
-- sqlly conditional: column=Sales; bar=#5B9BD5
-- sqlly column: Running Total = !Sales + N(!"Running Total"[1])
-- sqlly map: lat=Latitude; lon=Longitude; color=Region; cluster=on
Du musst sie selten eintippen. Ordne das Ergebnis so an, wie du es magst, und klicke dann auf das sperren vor dem Namen des Ergebnisses: SQLly schreibt die gesamte Anordnung als einen Block von Direktiven in die Abfrage. Siehe Raster sperren.
Die Direktiven-Familien
| Direktive | Was es bewirkt | Beispiel |
|---|---|---|
view: | Öffnet das Ergebnis als grid (die Standardeinstellung), pivot, oder chart; map behält das Raster und öffnet das Ergebnis zusätzlich auf einer Karte. | -- sqlly view: chart |
grid: | Die Spaltenanordnung des Rasters: Reihenfolge, ausgeblendete und eingefrorene Spalten, Sortierung, Gruppierung, Spaltenfilter und Fremdschlüsselbeschriftungen. grid 2: setzt ein Ergebnis-Set, gezählt ab 1. | -- sqlly grid: hide=Notes; freeze=1; sort=Total desc |
format: | Wie eine Ergebnis-Spalte angezeigt wird und wie breit sie ist. | -- sqlly format: column=Created; date=%Y-%m-%d; width=40dp |
conditional: | Färbt Zellen nach ihren Werten für diese Abfrage: eine Hervorhebungsregel, eine Farbskala oder einen Datenbalken. Eine Regel pro Zeile. | -- sqlly conditional: column=Status; when=is Failed; text=#B00020; bold |
column: | Fügt eine Spalte hinzu, die mit einer Excel-Formel aus den Spalten des Ergebnisses selbst berechnet wird: !Name ist diese Zeile, !Name[1] die vorherige Zeile. Funktionen und Operatoren von Excel. | -- sqlly column: Total = !Qty * !Price |
pivot: | Zeilen, Spalten und der aggregierte Wert einer Pivot-Tabelle. result:N wählt die Ergebnismenge aus, zu der es gehört. | -- sqlly pivot: row:Rep; column:Quarter; value:Deals:count |
chart: | Diagrammtyp, Kategoriebeschriftung, Datenreihe und Aggregation. result:N wählt die Ergebnismenge aus, zu der es gehört. | -- sqlly chart: kind:line; label:Month; values:Revenue,Cost |
map: | Wie ein Ergebnis auf der Karte dargestellt wird: Standortspalten, Beschriftungen und Tooltipps, Farbe und Größe, Punkte oder Heatmap (Gewicht, Radius, Unschärfe, Intensität, Deckkraft, Palette), Clustering, Straßenkarte, Startansicht, Klickverhalten und ob die Karte automatisch geöffnet wird. map 2: setzt ein Ergebnis-Set, gezählt ab 1. | -- sqlly map: mode=heatmap; weight=orders; radius=30 |
/* sqlly lock | Ein Blockkommentar, den SQLly schreibt, wenn man auf das Schloss eines Ergebnisses klickt. Seine -- sqlly Zeilen geben das Ergebnis genau so wieder, wie es aussah. | /* sqlly lock — … … */ |
name | Beschriftet den Tab eines Ergebnissets, gezählt ab 1. Praktisch, wenn ein Batch mehrere zurückgibt. | -- sqlly name 2: Open Orders |
2x2 / result: | Legt mehrere Ergebnismengen auf eine Leinwand und platziert das Ergebnis jeder Anweisung in einer Zelle. | -- sqlly result: 1|2 |
layout: | Öffnet die Ergebnisse des Laufs als stacked, tabbed, oder canvas, wo auch immer die Datei geöffnet wird. | -- sqlly layout: stacked |
lines: | Zeilen, die jeder gestapelten Karte zugewiesen sind; lines 2: setzt ein Ergebnis-Set, gezählt ab 1. | -- sqlly lines 2: 20 |
focus: | Welche Ergebnismenge angezeigt wird, wenn Ergebnisse eintreffen: ihr Tab ist in Tabbed ausgewählt, und ihre Karte wird in Stacked in die Ansicht gescrollt. Zählt ab 1. | -- sqlly focus: 2 |
param: | Deklariert einen Parameter oder vergibt einen :name Platzhalter einen Typ und Standardwert. Ein Streifen über den Ergebnissen ermöglicht es, seinen Wert vor jedem Lauf einzugeben; einfache :id, ? und $1 Platzhalter erhalten einen ohne Deklaration (siehe Abfrageparameter). | -- sqlly param: @CustomerId int |
set | Definiert eine Textvariable, die jedes ${name} vor der Ausführung der Abfrage ersetzt. | -- sqlly set schema = dbo |
param: und set sind die beiden, die das ändern, was die Datenbank bekommt. SQLly setzt ihre Werte vor dem Senden in das SQL ein, außerhalb von Zeichenfolgen und Kommentaren. Der Wert eines Parameters geht als maskiertes Literal seines deklarierten Typs hinein (text, int, decimal, bool, date, oder datetime). Ein set Wert wird unverändert eingesetzt. Berechnete-Spalte Formeln lesen beide als @name.
Wo eine Anweisung stehen muss
- Auf einer eigenen Zeile. Eine Direktive nach SQL-Code in derselben Zeile wird ignoriert.
nameist die einzige Ausnahme und funktioniert als nachgestellter Kommentar. view:und die Leinwandgröße stehen in der ersten Zeile. Sie werden nur in der ersten nicht-leeren Zeile der Abfrage gelesen. In einem Lock-Block am Anfang zählt die erste Direktivenzeile des Blocks als diese erste Zeile.- Abstände sind unkritisch für die meisten Familien:
--sqlly view: pivotund-- SQLLY view: pivotbeide funktionieren. format:ist strikt. Sie muss exakt so geschrieben werden wie-- sqlly format:, mit einem Leerzeichen danach--.- Innerhalb eines Blockkommentars wird eine Direktive deaktiviert - eine praktische Art, eine vorübergehend zu deaktivieren. Die einzige Ausnahme ist die
/* sqlly lockblock: ihre Zeilen funktionieren genau so, als wäre jede auf einer eigenen Zeile geschrieben.
-- sqlly view: pivot -- sqlly pivot: row:Region; column:Year; value:Sales:sum -- sqlly format: column=Sales; number=2 SELECT Region, Year, Sales FROM sales;
sqlly Wenn ein Namespace falsch geschrieben ist, an einer Stelle steht, wo er nicht angewendet werden kann, oder einen unbekannten Wert erhält, unterstreicht SQLly ihn im Editor und sagt, warum, anstatt ihn stillschweigend zu ignorieren. Zum Beispiel, -- sqlly view: table ergibt Unbekannte Ansicht — erwartet -- sqlly view: grid, -- sqlly view: pivot, -- sqlly view: chart, oder -- sqlly view: map.Autocomplete as you type
You don't have to remember any of the spellings above. As soon as a comment looks like a directive, the editor's suggestion list follows the cursor through it and offers the next thing the directive can take:
| You have typed | The list offers |
|---|---|
-- on a line of its own | A ready-made starter line for each kind of directive. view: and the canvas size are offered only on the query's first line, where they work. |
-- sq | das sqlly namespace. |
-- sqlly | Every directive family: view:, grid:, format:, pivot:, chart: and the rest. |
-- sqlly grid: | The settings that family takes, leaving out the ones already on the line. |
-- sqlly grid: sort= | The values that setting accepts: here the result's columns. Elsewhere chart kinds, pivot aggregates, filter operators, map modes, number and date formats, time zones, colors. |
-- sqlly grid: sort=Total | What may follow the value: here asc oder desc. |
- One choice opens the next. Accepting a setting opens its values straight away, so a whole directive can be built by picking from lists with Tab or Enter.
- Your real column names. Wherever a directive expects a column, the list shows the columns the tab's last run returned, quoted the way that directive needs them. Run the query once to get them.
- Formulas and parameters too. In a
column:formula the list completes column references, Excel worksheet functions and@variables. On aparam:line it offers the query's placeholders that are not declared yet, then every parameter type. - Only what works. Everything in the list is exactly what the directive accepts, so an accepted suggestion never earns the warning underline described above.
- Bring it back anywhere inside a directive with Strg+Leerzeichen, on macOS too.
Hilfe in der App
- Hover beliebig
-- sqllyKommentar für eine kurze Beschreibung, mit einem Link zur vollständigen Liste der Optionen. - Hilfe › Formatierungsanweisungen… (auch in der Befehlspalette) öffnet ein Referenzfenster mit jeder Familie, ihren Parametern und kopierfertigen Beispielen.
- Lass SQLly es schreiben. Klicke auf das Schloss vor dem Namen eines Ergebnisses, um das gesamte Ergebnis als Direktiven zu schreiben, oder klicke mit der rechten Maustaste auf einen Spaltenkopf des Ergebnisses und wähle Format › Formatierungsüberschreibung festlegen… um eine
format:Direktive für dich zu schreiben.
In diesem Abschnitt
- Raster
- Schreibe die Spaltenreihenfolge, ausgeblendete und eingefrorene Spalten, Sortierung, Gruppierung und Filter in die Abfrage.
- Formatierung in Arbeit
- Gib jeder Spalte die Darstellung und Breite, die sie verdient, automatisch jedes Mal, wenn die Abfrage läuft.
- Bedingt
- Färben Sie Zellen nach ihren Werten für eine Abfrage: Hervorhebungsregeln, Farbskalen und Datenbalken.
- Berechnete Spalten
- Füge Spalten hinzu, die als Excel-Formeln geschrieben sind: laufende Summen, Margen, Änderungen gegenüber der Zeile davor und Datumswerte.
- Pivot
- Verwandle eine vertraute Ergebnismenge mit einem kurzen, portablen Kommentar in eine Kreuztabelle.
- Diagramm
- Sag dem Tab „Diagramm“, welche Geschichte er zeichnen soll, bevor das Ergebnis überhaupt da ist.
- Raster sperren
- Ein Klick schreibt das Ergebnis genau so, wie es jetzt aussieht, in die Abfrage, damit jeder Lauf dasselbe liefert.