Диаграмма

функциональный

Скажите вкладке «Диаграмма», какую историю рисовать, ещё до того, как результат появится.

Директива диаграммы подготавливает Диаграмма результата из комментария. Это та же диаграмма, которую вы можете настроить интерактивно, но настройки путешествуют вместе с запросом и возвращаются при каждом запуске. Используйте представление директиву, чтобы открыть вкладку «Диаграмма», и график директиву для типа, меток, серий и агрегирования.

Синтаксис

-- 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: значение рисует свою метку. Галерея ниже подсказывает, чего ожидать; скриншоты там пока заглушки, которые ждут своих настоящих снимков.

SQLly
Столбчатая диаграмма SQLlyСтолбчатая диаграмма SQLly
kind:bar, сгруппированные столбцы вокруг нулевой линии, по одному столбцу на ряд в каждой категории.
SQLly
Линейная диаграмма SQLlyЛинейная диаграмма SQLly
kind:line, одна ломаная на ряд, с разрывами на значениях NULL.
SQLly
Площадная диаграмма SQLlyПлощадная диаграмма SQLly
kind:area, залитые полилинии на оси, которая начинается с нуля.
SQLly
Диаграмма рассеяния SQLlyДиаграмма рассеяния SQLly
kind:scatter, маркеры-точки по категориям, хорошо показывает разброс.
SQLly
Гистограмма SQLlyГистограмма SQLly
kind:histogram, интервалы с аккуратными границами для одного числового столбца.
SQLly
Круговая диаграмма SQLlyКруговая диаграмма SQLly
kind:pie, секторы-доли одного неотрицательного ряда.
SQLly
Кольцевая диаграмма SQLlyКольцевая диаграмма SQLly
kind:donut — круговая диаграмма с пустой серединой.
Используйте отдельные строки-комментарии. Поместите view: chart на первой непустой строке запроса; chart: может занимать отдельную строку комментария. Если валидных подсказок для диаграммы несколько, побеждает последняя.