---
title: "Локальные SQL-дашборды в виде текстовых файлов | DuckLocal"
description: "Создавайте дашборды DuckDB в виде текстовых файлов .dash: SQL-запросы, графики, карточки, карты и перекрёстные фильтры работают на вашем компьютере, проверяются в git, а ИИ-агент может их редактировать и валидировать."
image: https://ducklocal.app/og-image.jpg?v=2
language: ru
---

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

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

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

- Текстовые файлы .dash
- Графики, карточки, карты, таблицы
- Фильтрация между графиками по клику
- Проверка через ducklocal check

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

Блоки `source` указывают файлы данных, блоки `query` содержат SQL, а блоки `plot` описывают, как рисовать каждый результат. Блок `filter` делает так, что клик по одному графику сужает остальные. Никаких функций и шаблонов — только SQL и несколько атрибутов.

Пути указываются относительно файла `.dash`, поэтому папка со спецификацией и данными работает, куда её ни скопируй.

[Все блоки и атрибуты](https://ducklocal.app/docs/ru/dashboards#blocks)

```hcl
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**Сортируемые строки, заголовки и заметки
[Типы графиков и параметры →](https://ducklocal.app/docs/ru/dashboards#plot-types)

## Ревью дашборда как документа

Наведите курсор на график, нажмите на облачко и напишите, что нужно изменить, например *«отсортируй, самый крупный канал первым»*. На обсуждения можно отвечать и закрывать их, а график с открытыми обсуждениями показывает их число.

ИИ-агент читает те же обсуждения через `ducklocal comments`. В каждом указан график и строки его блока в файле. Агент правит спецификацию, проверяет её и отвечает. Открытое окно перерисовывается меньше чем за секунду и показывает ответ с пометкой **Agent**.

[Ревью с комментариями](https://ducklocal.app/docs/ru/dashboards#review-with-comments) · [Чему Claude Dashboards научил меня о DuckLocal](https://ducklocal.app/ru/blog/claude-dashboards-ducklocal/)

```bash
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.

[Проверка дашборда](https://ducklocal.app/docs/ru/dashboards#validate-a-dashboard)

- Проверка синтаксиса, имён и ссылок
- SQL каждого запроса выполняется в DuckDB
- Столбцы графиков сверяются с реальными результатами
- Фильтры проверяются с выбранным значением
- Запросы без строк помечаются

## Данные остаются у вас, файл можно передать

Запросы выполняются движком DuckDB внутри DuckLocal над файлами на вашем диске или базой данных DuckDB. Отправьте папку коллеге — он увидит тот же дашборд на своей копии данных, без публикации и общих рабочих пространств.

> **Начинаете с одного запроса?** Любой результат в редакторе SQL можно сразу превратить в график. Пишите файл `.dash`, когда набор графиков стоит сохранить. [Результаты и графики →](https://ducklocal.app/docs/ru/results-and-charts)

## Вопросы о SQL-дашбордах

**Что такое файл .dash?** Текстовый файл, описывающий дашборд блоками: `source` указывает файлы данных, `query` содержит одну инструкцию SQL DuckDB, `plot` рисует результат, а `filter` делает так, что клик по одному графику сужает остальные. Писать код не нужно.

**Нужен ли дашборду сервер или учётная запись BI?** Нет. DuckLocal открывает файл и выполняет его запросы движком DuckDB внутри приложения, на вашем компьютере. Файлы данных остаются на месте.

**Какие графики доступны?** Линейные, столбчатые, столбчатые с накоплением, с областями, точечные, круговые, тепловые карты, гистограммы, карты и временные шкалы, а также таблицы, числовые карточки с индикатором изменения и текстовые панели на сетке из 12 колонок.

**Может ли ИИ-агент создать или изменить дашборд?** Да. Агент пишет или правит файл .dash, запускает `ducklocal check`, чтобы убедиться, что каждый запрос выполняется и столбцы каждого графика существуют, и отвечает на комментарии ревью через `ducklocal comments`. Открытое окно перерисовывается меньше чем за секунду.

**Можно ли хранить дашборды в git?** Да. Файл .dash — короткий текст, его можно сравнивать и ревьюить как код. Комментарии ревью хранятся в отдельном файле `NAME.dash.comments.json`, который можно не добавлять в систему контроля версий.

Похожие страницы: [SQL для ИИ-агентов](https://ducklocal.app/ru/use-cases/ai-agent-sql/) · [Локальный анализ данных](https://ducklocal.app/ru/use-cases/local-data-analysis/) · [Интерфейс DuckDB](https://ducklocal.app/ru/use-cases/duckdb-gui/) · [Запросы к CSV через SQL](https://ducklocal.app/ru/use-cases/query-csv-with-sql/)

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

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

## Ссылки

- [Скачать DuckLocal](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Руководство по дашбордам](https://ducklocal.app/docs/ru/dashboards)
- [Посмотреть полный пример](https://ducklocal.app/docs/ru/dashboards#a-complete-example)

Source: https://ducklocal.app/ru/use-cases/sql-dashboards/
