SQL-дашборды, которые можно читать, сравнивать и ревьюить

Дашборд DuckLocal — это текстовый файл .dash: источники данных, SQL-запросы DuckDB и графики, которые их отображают. Он работает на вашем компьютере с локальными файлами, хранится в git как код, и написать его можете вы сами или ИИ-агент.

Без BI-сервера, без учётной записи, без загрузки данных. Бесплатно и с открытым исходным кодом для macOS, Windows и Linux.

Дашборд — это короткий файл

Блоки 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

Terminal
$ 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, который можно не добавлять в систему контроля версий.

Откройте пример дашборда

Скачайте DuckLocal, сохраните рядом файлы sales.csv и sales.dash из руководства и перетащите дашборд в окно.