Gráfico
funcionalDiga à aba Gráfico qual história desenhar antes mesmo do resultado chegar.
A diretiva de gráfico prepara a Gráfico aba a partir de um comentário. É o mesmo gráfico que você pode configurar interativamente, mas a configuração acompanha a consulta e volta em cada execução. Use uma visão diretiva para abrir a aba Gráfico e uma gráfico diretiva para o tipo, rótulos, séries e agregação.
Sintaxe
-- sqlly view: chart
-- sqlly chart: kind:<type>[; label:<col>][; values:<cols>][; aggregate:<agg>][; order:<order>][; top:<n>][; navigate:<true|false>][; result:<n>]
Os campos são separados por ; e escrito como key:value; a ordem não importa. Apenas kind: é obrigatório, e o restante usa os padrões do gráfico quando omitido. Os nomes das colunas são flexíveis, então [Region], `Region`, e "Region" todos resolvem para a mesma coluna.
| Campo | Significado |
|---|---|
kind: | O tipo de gráfico: bar, line, area, scatter, histogram, pie, ou donut (obrigatório). |
label:col | Coluna cujos valores rotulam as categorias. O padrão é a primeira coluna de texto. |
values:col[,col…] | Coluna(s) numérica(s) para plotar como séries. O padrão é detectar automaticamente as colunas numéricas. |
aggregate:agg | Recolher linhas por categoria: none, sum, average, minimum, maximum, ou count. (avg/min/max também aceito.) |
order:order | Ordem das categorias: source, category (A–Z), ou value (alto–baixo). |
top:n | Manter no máximo n categorias após a ordenação. |
navigate:true|false | Clicar em um marcador seleciona suas linhas de origem na aba Grade (padrão) true). |
result:n | O conjunto de resultados ao qual o gráfico pertence, contando a partir de 1. O padrão é o primeiro resultado. |
Exemplos
-- sqlly view: chart
-- sqlly chart: kind:bar; label:Region; values:Sales
SELECT Region, Sales FROM sales;
Para duas séries, somadas por categoria e exibidas com a maior primeiro:
-- sqlly view: chart
-- sqlly chart: kind:line; label:Month; values:Revenue,Cost; aggregate:sum; order:value; top:12
SELECT Month, Revenue, Cost FROM monthly;
Quando um lote retorna vários conjuntos de resultados, result: desenha o gráfico para uma série posterior:
-- sqlly chart: kind:bar; label:Region; values:Total; result:2
SELECT COUNT(*) FROM sales;
SELECT Region, Total FROM sales;
Tipos de gráfico
Cada kind: valor desenha uma marca diferente. A galeria abaixo indica o que esperar; seus espaços reservados de captura de tela estão aguardando suas capturas reais.














view: chart na primeira linha não vazia da consulta; chart: pode ficar sozinha em qualquer linha de comentário. Quando existem várias dicas de gráfico válidas, vale a última.