Graphique
fonctionnelIndiquez à l'onglet Graphique quelle histoire dessiner avant même que le résultat n'arrive.
La directive de graphique prépare l'onglet Graphique du résultat à partir d'un commentaire. C'est le même graphique que vous pouvez configurer de manière interactive, mais la configuration accompagne la requête et revient à chaque exécution. Utilisez une vue directive pour ouvrir l'onglet Graphique et une graphique directive pour le type, les étiquettes, les séries et l'agrégation.
Syntaxe
-- sqlly view: chart
-- sqlly chart: kind:<type>[; label:<col>][; values:<cols>][; aggregate:<agg>][; order:<order>][; top:<n>][; navigate:<true|false>][; result:<n>]
Les champs sont séparés par ; et écrit comme key:value; l'ordre n'a pas d'importance. Seulement kind: est requis, et le reste utilise les valeurs par défaut du graphique lorsqu'elles sont omises. Les noms de colonnes sont flexibles, donc [Region], `Region`, et "Region" tous se résolvent en la même colonne.
| Champ | Sens |
|---|---|
kind: | Le type de graphique : bar, line, area, scatter, histogram, pie, ou donut (requis). |
label:col | Colonne dont les valeurs étiquettent les catégories. Par défaut, la première colonne de texte. |
values:col[,col…] | Colonne(s) numérique(s) à tracer en tant que séries. Par défaut, détection automatique des colonnes numériques. |
aggregate:agg | Regrouper les lignes par catégorie : none, sum, average, minimum, maximum, ou count. (avg/min/max aussi accepté.) |
order:order | Ordre des catégories : source, category (A–Z), ou value (du plus haut au plus bas). |
top:n | Conserver au maximum n catégories après tri. |
navigate:true|false | Cliquer sur un repère sélectionne ses lignes sources dans l'onglet Grille (par défaut true). |
result:n | L'ensemble de résultats auquel le graphique appartient, en comptant à partir de 1. Par défaut, le premier résultat. |
Exemples
-- sqlly view: chart
-- sqlly chart: kind:bar; label:Region; values:Sales
SELECT Region, Sales FROM sales;
Pour deux séries, additionnées par catégorie et affichées du plus grand au plus petit :
-- sqlly view: chart
-- sqlly chart: kind:line; label:Month; values:Revenue,Cost; aggregate:sum; order:value; top:12
SELECT Month, Revenue, Cost FROM monthly;
Lorsqu'un lot renvoie plusieurs ensembles de résultats, result: dessine le graphique pour un suivant :
-- sqlly chart: kind:bar; label:Region; values:Total; result:2
SELECT COUNT(*) FROM sales;
SELECT Region, Total FROM sales;
Types de graphiques
Chaque kind: valeur affiche une marque différente. La galerie ci-dessous indique à quoi vous attendre ; ses espaces réservés de captures d'écran attendent leurs vraies images.














view: chart sur la première ligne non vide de la requête ; chart: peut se trouver sur n'importe quelle ligne de commentaire seule. Lorsqu'il existe plusieurs indications de graphique valides, la dernière l'emporte.