Диаграмма
функциональныйСкажите вкладке «Диаграмма», какую историю рисовать, ещё до того, как результат появится.
Директива диаграммы подготавливает Диаграмма результата из комментария. Это та же диаграмма, которую вы можете настроить интерактивно, но настройки путешествуют вместе с запросом и возвращаются при каждом запуске. Используйте представление директиву, чтобы открыть вкладку «Диаграмма», и график директиву для типа, меток, серий и агрегирования.
Синтаксис
-- sqlly view: chart
-- sqlly chart: kind:<type>[; label:<col>][; values:<cols>][; aggregate:<agg>][; order:<order>][; top:<n>][; navigate:<true|false>][; result:<n>]
Поля разделяются ; и записывается как key:value; порядок не имеет значения. Только kind: обязателен, а остальные при отсутствии берут значения по умолчанию из диаграммы. Имена столбцов гибкие, поэтому [Region], `Region`, и "Region" все разрешаются в один и тот же столбец.
| Поле | Значение |
|---|---|
kind: | Тип диаграммы: bar, line, area, scatter, histogram, pie, или donut (требуется). |
label:col | Столбец, значения которого обозначают категории. По умолчанию первый текстовый столбец. |
values:col[,col…] | Числовые столбцы для отображения в виде ряда. По умолчанию числовые столбцы определяются автоматически. |
aggregate:agg | Свертка строк по категориям: none, sum, average, minimum, maximum, или count. (avg/min/max также принимается.) |
order:order | Порядок категорий: source, category (A–Z), или value (от высокого к низкому). |
top:n | Сохранять не более n категорий после сортировки. |
navigate:true|false | Щелчок по метке выбирает исходные строки на вкладке Сетка (по умолчанию true). |
result:n | Набор результатов, к которому относится диаграмма, нумерация с 1. По умолчанию — первый. |
Примеры
-- sqlly view: chart
-- sqlly chart: kind:bar; label:Region; values:Sales
SELECT Region, Sales FROM sales;
Два ряда с суммированием по категориям, от большего к меньшему:
-- sqlly view: chart
-- sqlly chart: kind:line; label:Month; values:Revenue,Cost; aggregate:sum; order:value; top:12
SELECT Month, Revenue, Cost FROM monthly;
Когда пакет возвращает несколько наборов результатов, result: строит диаграмму для последующего ряда:
-- sqlly chart: kind:bar; label:Region; values:Total; result:2
SELECT COUNT(*) FROM sales;
SELECT Region, Total FROM sales;
Типы диаграмм
Каждое kind: значение рисует свою метку. Галерея ниже подсказывает, чего ожидать; скриншоты там пока заглушки, которые ждут своих настоящих снимков.














view: chart на первой непустой строке запроса; chart: может занимать отдельную строку комментария. Если валидных подсказок для диаграммы несколько, побеждает последняя.