# Ваши первые 10 минут

> Десятиминутный учебник по DuckLocal с примером CSV: выполните запрос на SQL, постройте график по результатам, экспортируйте их и задайте тот же вопрос из CLI.

Source: https://ducklocal.app/docs/ru/tutorial

Небольшая экскурсия: откройте маленький файл продаж, выполните несколько
запросов, постройте графики по ответам и экспортируйте результаты.
Предполагается, что DuckLocal уже установлен; если нет, начните с раздела
[Начало работы](getting-started.md).

## 1. Получите файл с примером {#sample-file}

Скачайте [sales.csv](https://ducklocal.app/docs/samples/sales.csv) — две недели тестовых данных о заказах,
224 строки. Его также можно скачать из терминала:

```bash
curl -LO https://ducklocal.app/docs/samples/sales.csv
```

В нём пять столбцов:

| Столбец | Тип | Пример |
| --- | --- | --- |
| `date` | DATE | `2026-09-01` |
| `channel` | VARCHAR | `Web`, `Mobile app`, `Store`, `Phone` |
| `region` | VARCHAR | `North`, `South`, `East`, `West` |
| `orders` | BIGINT | `72` |
| `revenue` | DOUBLE | `4181.04` |

Ничего из этого не нужно сообщать DuckLocal: DuckDB читает заголовок и сам
определяет типы.

## 2. Откройте его

Перетащите `sales.csv` в окно DuckLocal. (Или нажмите **Открыть файлы…**, или
выполните `ducklocal sales.csv`, если вы [добавили
команду](getting-started.md#add-command).)

Уведомление подтвердит: **Создано представление sales.** В боковой панели в
**Локальных файлах** теперь есть `sales` с его 224 строками; разверните его,
чтобы увидеть столбцы и их типы.

## 3. Посмотрите на строки

В боковой панели нажмите кнопку воспроизведения рядом с `sales`. Редактор
заполнится запросом `SELECT * … LIMIT 100` для него — нажмите **⌘↵**, чтобы
выполнить.

Таблица под редактором показывает строки. Попробуйте поле фильтра над ней:
введите `Store` и нажмите Enter, чтобы оставить только строки, где оно
встречается. Фильтр работает по уже загруженным строкам и не выполняет запрос
заново.

## 4. Задайте вопрос

Замените SQL на этот и нажмите **⌘↵**:

```sql
SELECT channel, round(sum(revenue), 2) AS revenue
FROM sales
GROUP BY channel
ORDER BY revenue DESC;
```

| channel | revenue |
| --- | --- |
| Mobile app | 290549.76 |
| Web | 289544.8 |
| Store | 240067.6 |
| Phone | 82511.2 |

Теперь переключите панель результатов с **Результатов** на **График**. Поскольку
первый столбец текстовый, вы получите столбик для каждого канала, размер
которого задаёт первый числовой столбец.

::: tip Автодополнение
Пока вы печатаете, редактор сначала предлагает имена таблиц и столбцов из
боковой панели, затем функции DuckDB и ключевые слова SQL — наберите `rev`, и
`revenue` будет первым предложением.
:::

## 5. Постройте график тренда

Графики строятся по строкам ровно в том виде, в каком их возвращает запрос,
поэтому формируйте результат так, как хотите его увидеть. Один столбец на канал
даёт одну линию на канал:

```sql
SELECT
  date,
  round(sum(revenue) FILTER (WHERE channel = 'Web'), 2)        AS web,
  round(sum(revenue) FILTER (WHERE channel = 'Mobile app'), 2) AS mobile,
  round(sum(revenue) FILTER (WHERE channel = 'Store'), 2)      AS store
FROM sales
GROUP BY date
ORDER BY date;
```

`FILTER (WHERE …)` агрегирует только подходящие строки (синтаксис DuckDB).

Когда в первом столбце дата, **График** рисует график с областями по времени, по
одной серии на числовой столбец. Правила и ограничения описаны в разделе
[Результаты и графики](results-and-charts.md).

## 6. Экспортируйте ответ

**Экспорт перезаписывает существующий файл, не спрашивая.** Оставив тренд на
панели результатов, нажмите **Экспорт CSV**. Диалог предложит
`~/Desktop/export.csv`; при желании измените путь и подтвердите.

Экспорт повторно выполняет запрос, поэтому файл содержит полный результат, а не
только то, что видно в таблице.

## 7. Найдите его снова завтра

Откройте вкладку **История** в боковой панели: там есть каждый выполненный
запрос, включая неудачные. Щелчок по записи заменяет то, что сейчас хранит
редактор, — нажмите на запись, чтобы вернуть этот запрос в редактор.

Закройте DuckLocal и запустите снова. `sales` по-прежнему в **Локальных файлах**:
открытые файлы запоминаются по пути и читаются заново при каждом запуске,
поэтому правка CSV отразится при следующем запросе.

## 8. Бонус: тот же вопрос из терминала

Если вы добавили команду `ducklocal`, CLI ответит, не открывая окно, — удобно для
скриптов и ИИ-агентов:

```bash
ducklocal query --format md --sql "
  SELECT channel, round(sum(revenue), 2) AS revenue
  FROM 'sales.csv' GROUP BY channel ORDER BY revenue DESC"
```

Без `--format md` вы получите структурированный JSON. Начать стоит с
[руководства по CLI](cli.md) и официального навыка для агентов — пакета навыков,
который могут вызывать ИИ-помощники для программирования.

## Далее

- Попробуйте на реальных данных: 3,5 миллиона поездок такси, запрос по HTTPS — см. [Пример: поездки такси в Нью-Йорке](example-nyc-taxi.md)
- Укажите DuckLocal на свои файлы или папки — см. [Источники данных](data-sources.md)
- Запрашивайте файлы в S3-совместимом хранилище — см. [S3 и httpfs](s3.md)
- Соберите дашборд из сохранённых запросов — см. [Дашборды (.dash)](dashboards.md)
