Diagramm

funktional

Sag dem Tab „Diagramm“, welche Geschichte er zeichnen soll, bevor das Ergebnis überhaupt da ist.

Die Diagramm-Direktive bereitet das Diagramm Tab aus einem Kommentar vor. Es ist dasselbe Diagramm, das du auch interaktiv konfigurieren kannst, aber die Einrichtung reist mit der Abfrage mit und ist bei jedem Lauf wieder da. Verwende eine Ansicht Direktive, um das Diagramm-Tab zu öffnen, und eine Diagramm Direktive für Typ, Beschriftungen, Serien und Aggregation.

Syntax

-- sqlly view: chart
-- sqlly chart: kind:<type>[; label:<col>][; values:<cols>][; aggregate:<agg>][; order:<order>][; top:<n>][; navigate:<true|false>][; result:<n>]

Felder werden durch ; und geschrieben als key:value; die Reihenfolge spielt keine Rolle. Nur kind: ist erforderlich, und der Rest verwendet die Standardwerte des Diagramms, wenn er weggelassen wird. Spaltennamen sind flexibel, also [Region], `Region`, und "Region" alle verweisen auf dieselbe Spalte.

FeldBedeutung
kind:Der Diagrammtyp: bar, line, area, scatter, histogram, pie, oder donut (erforderlich).
label:colSpalte, deren Werte die Kategorien beschriften. Standardmäßig die erste Textspalte.
values:col[,col…]Numerische Spalte(n), die als Datenreihen geplottet werden. Standardmäßig werden die numerischen Spalten automatisch erkannt.
aggregate:aggZeilen pro Kategorie zusammenfassen: none, sum, average, minimum, maximum, oder count. (avg/min/max auch akzeptiert.)
order:orderKategorienreihenfolge: source, category (A–Z), oder value (von hoch nach niedrig).
top:nNach der Reihenfolge maximal n Kategorien.
navigate:true|falseEin Klick auf eine Markierung wählt ihre Quellzeilen im Raster-Tab aus (Standard true).
result:nDie Ergebnismenge, zu der das Diagramm gehört, gezählt ab 1. Standard ist das erste Ergebnis.

Beispiele

-- sqlly view: chart
-- sqlly chart: kind:bar; label:Region; values:Sales
SELECT Region, Sales FROM sales;

Bei zwei Serien, pro Kategorie summiert und mit der größten zuerst:

-- sqlly view: chart
-- sqlly chart: kind:line; label:Month; values:Revenue,Cost; aggregate:sum; order:value; top:12
SELECT Month, Revenue, Cost FROM monthly;

Wenn ein Batch mehrere Ergebnismengen zurückgibt, result: zeichnet das Diagramm für eine spätere Serie:

-- sqlly chart: kind:bar; label:Region; values:Total; result:2
SELECT COUNT(*) FROM sales;
SELECT Region, Total FROM sales;

Diagrammtypen

Jeder kind: Wert zeichnet ein anderes Zeichen. Die Galerie unten nennt, was zu erwarten ist; ihre Screenshot-Platzhalter warten auf ihre echten Aufnahmen.

SQLly
Ein SQLly-BalkendiagrammEin SQLly-Balkendiagramm
kind:bar, gruppierte Balken um eine Nulllinie, ein Balken pro Datenreihe und Kategorie.
SQLly
Ein SQLly-LiniendiagrammEin SQLly-Liniendiagramm
kind:line, eine Linie pro Datenreihe, mit Lücken bei NULL-Werten.
SQLly
Ein SQLly-FlächendiagrammEin SQLly-Flächendiagramm
kind:area, gefüllte Polylinien auf einer Achse, die bei null beginnt.
SQLly
Ein SQLly-StreudiagrammEin SQLly-Streudiagramm
kind:scatter, Punktmarker pro Kategorie, gut für die Streuung.
SQLly
Ein SQLly-HistogrammEin SQLly-Histogramm
kind:histogram, Bins mit glatten Grenzen für eine einzelne numerische Spalte.
SQLly
Ein SQLly-KreisdiagrammEin SQLly-Kreisdiagramm
kind:pie, radiale Anteile einer einzelnen nicht negativen Datenreihe.
SQLly
Ein SQLly-Donut-DiagrammEin SQLly-Donut-Diagramm
kind:donut - ein Ringdiagramm mit ausgesparter Mitte.
Verwende eigenständige Kommentarzeilen. Setze view: chart auf der ersten nichtleeren Zeile der Abfrage; chart: kann auf jeder eigenen Kommentarzeile stehen. Wenn mehrere gültige Diagrammhinweise existieren, gewinnt der letzte.