Дашборд — это короткий файл
Блоки source указывают файлы данных, блоки query содержат SQL, а блоки plot описывают, как рисовать каждый результат. Блок filter делает так, что клик по одному графику сужает остальные. Никаких функций и шаблонов — только SQL и несколько атрибутов.
Пути указываются относительно файла .dash, поэтому папка со спецификацией и данными работает, куда её ни скопируй.
source "orders" { path = "orders.csv" } query "revenue" { sql = <<SQL SELECT channel, sum(amount) AS total FROM orders GROUP BY channel ORDER BY total DESC SQL } plot "revenue" { type = "bar" query = query.revenue x = channel y = total }
Графики, которые нужны дашборду
Привычные графики, числа и карты на сетке из 12 колонок.
- line · areaВременные ряды, до 12 рядов на график
- bar · stacked_barРейтинги и доли целого, с итогами
- scatter · histogramЗависимости и распределения
- heatmapДень недели по часам, регион по месяцам
- mapТочки по широте и долготе, с размером и цветом
- timelineСобытия на реальном расстоянии во времени, по дорожкам
- cardОдно число и его изменение — хорошее или плохое
- table · textСортируемые строки, заголовки и заметки
Ревью дашборда как документа
Наведите курсор на график, нажмите на облачко и напишите, что нужно изменить, например «отсортируй, самый крупный канал первым». На обсуждения можно отвечать и закрывать их, а график с открытыми обсуждениями показывает их число.
ИИ-агент читает те же обсуждения через ducklocal comments. В каждом указан график и строки его блока в файле. Агент правит спецификацию, проверяет её и отвечает. Открытое окно перерисовывается меньше чем за секунду и показывает ответ с пометкой Agent.
Ревью с комментариями · Чему Claude Dashboards научил меня о DuckLocal
$ ducklocal comments sales.dash {"open":1, "threads":[{"id":"c1", "plot":"revenue_by_channel", "plot_lines":[68,75], ...}]} $ ducklocal check sales.dash $ ducklocal comments sales.dash --reply c1 \ --text "Sorted by revenue, descending" --resolve
Проверено до того, как кто-то откроет
ducklocal check разбирает файл, разрешает каждую ссылку и выполняет каждый запрос в режиме только для чтения. Затем убеждается, что столбцы каждого графика есть в реальном результате, — опечатка, неудачное приведение типов или glob без совпадений обнаружатся в терминале, а не на встрече.
Все проблемы выводятся сразу, по одной в формате file:line: message, с кодами возврата, на которые может опираться скрипт или CI.
- Проверка синтаксиса, имён и ссылок
- SQL каждого запроса выполняется в DuckDB
- Столбцы графиков сверяются с реальными результатами
- Фильтры проверяются с выбранным значением
- Запросы без строк помечаются
Данные остаются у вас, файл можно передать
Запросы выполняются движком DuckDB внутри DuckLocal над файлами на вашем диске или базой данных DuckDB. Отправьте папку коллеге — он увидит тот же дашборд на своей копии данных, без публикации и общих рабочих пространств.
Вопросы о SQL-дашбордах
- Что такое файл .dash?
- Текстовый файл, описывающий дашборд блоками:
sourceуказывает файлы данных,queryсодержит одну инструкцию SQL DuckDB,plotрисует результат, аfilterделает так, что клик по одному графику сужает остальные. Писать код не нужно. - Нужен ли дашборду сервер или учётная запись BI?
- Нет. DuckLocal открывает файл и выполняет его запросы движком DuckDB внутри приложения, на вашем компьютере. Файлы данных остаются на месте.
- Какие графики доступны?
- Линейные, столбчатые, столбчатые с накоплением, с областями, точечные, круговые, тепловые карты, гистограммы, карты и временные шкалы, а также таблицы, числовые карточки с индикатором изменения и текстовые панели на сетке из 12 колонок.
- Может ли ИИ-агент создать или изменить дашборд?
- Да. Агент пишет или правит файл .dash, запускает
ducklocal check, чтобы убедиться, что каждый запрос выполняется и столбцы каждого графика существуют, и отвечает на комментарии ревью черезducklocal comments. Открытое окно перерисовывается меньше чем за секунду. - Можно ли хранить дашборды в git?
- Да. Файл .dash — короткий текст, его можно сравнивать и ревьюить как код. Комментарии ревью хранятся в отдельном файле
NAME.dash.comments.json, который можно не добавлять в систему контроля версий.
Похожие страницы: SQL для ИИ-агентов · Локальный анализ данных · Интерфейс DuckDB · Запросы к CSV через SQL
Откройте пример дашборда
Скачайте DuckLocal, сохраните рядом файлы sales.csv и sales.dash из руководства и перетащите дашборд в окно.