Gráfico
funcionalDile a la pestaña Gráfico qué historia dibujar antes incluso de que llegue el resultado.
La directiva del gráfico prepara el resultado Gráfico pestaña de un comentario. Es el mismo gráfico que puedes configurar de manera interactiva, pero la configuración viaja con la consulta y vuelve en cada ejecución. Usa una vista directiva para abrir la pestaña de Gráfico y una chart directiva para el tipo, etiquetas, series y agregación.
Sintaxis
-- sqlly view: chart
-- sqlly chart: kind:<type>[; label:<col>][; values:<cols>][; aggregate:<agg>][; order:<order>][; top:<n>][; navigate:<true|false>][; result:<n>]
Los campos están separados por ; y escritos como key:value; el orden no importa. Solo kind: es obligatorio; el resto usa los valores predeterminados del gráfico si se omiten. Los nombres de las columnas son flexibles, así que [Region], `Region`, y "Region" todos se resuelven en la misma columna.
| Campo | Significado |
|---|---|
kind: | El tipo de gráfico: bar, line, area, scatter, histogram, pie, o donut (obligatorio). |
label:col | Columna cuyos valores etiquetan las categorías. Por defecto es la primera columna de texto. |
values:col[,col…] | Columna(s) numérica(s) para graficar como series. Por defecto se detectan automáticamente las columnas numéricas. |
aggregate:agg | Contraer filas por categoría: none, sum, average, minimum, maximum, o count. (avg/min/max también aceptado.) |
order:order | Orden de categorías: source, category (A–Z), o value (alto–bajo). |
top:n | Mantener como máximo n categorías después de ordenar. |
navigate:true|false | Hacer clic en una marca selecciona sus filas de origen en la pestaña de la cuadrícula (por defecto true). |
result:n | El conjunto de resultados al que pertenece el gráfico, contando desde 1. Por defecto, el primer resultado. |
Ejemplos
-- sqlly view: chart
-- sqlly chart: kind:bar; label:Region; values:Sales
SELECT Region, Sales FROM sales;
Para dos series, sumadas por categoría y mostradas de mayor a menor:
-- sqlly view: chart
-- sqlly chart: kind:line; label:Month; values:Revenue,Cost; aggregate:sum; order:value; top:12
SELECT Month, Revenue, Cost FROM monthly;
Cuando un lote devuelve varios conjuntos de resultados, result: dibuja el gráfico para uno posterior:
-- sqlly chart: kind:bar; label:Region; values:Total; result:2
SELECT COUNT(*) FROM sales;
SELECT Region, Total FROM sales;
Tipos de gráficos
Cada kind: cada valor dibuja una marca distinta. La galería de abajo indica qué esperar; sus marcadores de captura esperan sus capturas reales.














view: chart en la primera línea no vacía de la consulta; chart: puede estar en cualquier línea de comentarios dedicada. Cuando hay varias sugerencias de gráfico válidas, gana la última.