SQLly-Direktiven

funktional

Kleine 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

DirektiveWas es bewirktBeispiel
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 lockEin 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 — … … */
nameBeschriftet 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
setDefiniert 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. name ist 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: pivot und -- SQLLY view: pivot beide 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 lock block: 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;
Ein Sicherheitsnetz, während du tippst. Wenn ein Kommentar den 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 typedThe list offers
-- on a line of its ownA 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.
-- sqdas 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 a param: 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 -- sqlly Kommentar 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.