Ваши первые 10 минут
Небольшая экскурсия: откройте маленький файл продаж, выполните несколько запросов, постройте графики по ответам и экспортируйте результаты. Предполагается, что DuckLocal уже установлен; если нет, начните с раздела Начало работы.
1. Получите файл с примером
Скачайте sales.csv — две недели тестовых данных о заказах, 224 строки. Его также можно скачать из терминала:
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, если вы добавили команду.)
Уведомление подтвердит: Создано представление sales. В боковой панели в Локальных файлах теперь есть sales с его 224 строками; разверните его, чтобы увидеть столбцы и их типы.
3. Посмотрите на строки
В боковой панели нажмите кнопку воспроизведения рядом с sales. Редактор заполнится запросом SELECT * … LIMIT 100 для него — нажмите ⌘↵, чтобы выполнить.
Таблица под редактором показывает строки. Попробуйте поле фильтра над ней: введите Store и нажмите Enter, чтобы оставить только строки, где оно встречается. Фильтр работает по уже загруженным строкам и не выполняет запрос заново.
4. Задайте вопрос
Замените 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 |
Теперь переключите панель результатов с Результатов на График. Поскольку первый столбец текстовый, вы получите столбик для каждого канала, размер которого задаёт первый числовой столбец.
Автодополнение
Пока вы печатаете, редактор сначала предлагает имена таблиц и столбцов из боковой панели, затем функции DuckDB и ключевые слова SQL — наберите rev, и revenue будет первым предложением.
5. Постройте график тренда
Графики строятся по строкам ровно в том виде, в каком их возвращает запрос, поэтому формируйте результат так, как хотите его увидеть. Один столбец на канал даёт одну линию на канал:
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 ответит, не открывая окно, — удобно для скриптов и ИИ-агентов:
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 и официального навыка для агентов — пакета навыков, который могут вызывать ИИ-помощники для программирования.
Далее
- Попробуйте на реальных данных: 3,5 миллиона поездок такси, запрос по HTTPS — см. Пример: поездки такси в Нью-Йорке
- Укажите DuckLocal на свои файлы или папки — см. Источники данных
- Запрашивайте файлы в S3-совместимом хранилище — см. S3 и httpfs
- Соберите дашборд из сохранённых запросов — см. Дашборды (.dash)
