Перейти к содержимому

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

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

1. Получите файл с примером ​

Скачайте sales.csv — две недели тестовых данных о заказах, 224 строки. Его также можно скачать из терминала:

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

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

СтолбецТипПример
dateDATE2026-09-01
channelVARCHARWeb, Mobile app, Store, Phone
regionVARCHARNorth, South, East, West
ordersBIGINT72
revenueDOUBLE4181.04

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

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

Перетащите sales.csv в окно DuckLocal. (Или нажмите Открыть файлы…, или выполните ducklocal sales.csv, если вы добавили команду.)

Уведомление подтвердит: Создано представление 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;
channelrevenue
Mobile app290549.76
Web289544.8
Store240067.6
Phone82511.2

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

Автодополнение

Пока вы печатаете, редактор сначала предлагает имена таблиц и столбцов из боковой панели, затем функции 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).

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

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 и официального навыка для агентов — пакета навыков, который могут вызывать ИИ-помощники для программирования.

Далее ​

Опубликовано под лицензией Apache-2.0.