Graphique

fonctionnel

Indiquez à 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.

ChampSens
kind:Le type de graphique : bar, line, area, scatter, histogram, pie, ou donut (requis).
label:colColonne 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:aggRegrouper les lignes par catégorie : none, sum, average, minimum, maximum, ou count. (avg/min/max aussi accepté.)
order:orderOrdre des catégories : source, category (A–Z), ou value (du plus haut au plus bas).
top:nConserver au maximum n catégories après tri.
navigate:true|falseCliquer sur un repère sélectionne ses lignes sources dans l'onglet Grille (par défaut true).
result:nL'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.

SQLly
Un graphique à barres SQLlyUn graphique à barres SQLly
kind:bar, barres groupées autour d’une ligne de base zéro, une barre par série et par catégorie.
SQLly
Un graphique en lignes SQLlyUn graphique en lignes SQLly
kind:line, une polyligne par série, avec des interruptions sur les valeurs NULL.
SQLly
Un graphique en aires SQLlyUn graphique en aires SQLly
kind:area, polylignes remplies sur un axe qui part de zéro.
SQLly
Un nuage de points SQLlyUn nuage de points SQLly
kind:scatter, marqueurs de points par catégorie, idéal pour visualiser la dispersion.
SQLly
Un histogramme SQLlyUn histogramme SQLly
kind:histogram, classes aux bornes arrondies d'une seule colonne numérique.
SQLly
Un graphique circulaire SQLlyUn graphique circulaire SQLly
kind:pie, parts radiales d'une seule série non négative.
SQLly
Un graphique en anneau SQLlyUn graphique en anneau SQLly
kind:donut - un camembert dont le centre est évidé.
Utilisez des lignes de commentaire autonomes. Mettez 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.