Diagramm
funktionalSag 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.
| Feld | Bedeutung |
|---|---|
kind: | Der Diagrammtyp: bar, line, area, scatter, histogram, pie, oder donut (erforderlich). |
label:col | Spalte, 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:agg | Zeilen pro Kategorie zusammenfassen: none, sum, average, minimum, maximum, oder count. (avg/min/max auch akzeptiert.) |
order:order | Kategorienreihenfolge: source, category (A–Z), oder value (von hoch nach niedrig). |
top:n | Nach der Reihenfolge maximal n Kategorien. |
navigate:true|false | Ein Klick auf eine Markierung wählt ihre Quellzeilen im Raster-Tab aus (Standard true). |
result:n | Die 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.














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.