В марте 2025 года вместе с DuckDB 1.2.1 появился DuckDB UI: запустите duckdb -ui, и в браузере откроется блокнот, обслуживаемый процессом DuckDB на вашей машине. С тех пор самый частый вопрос о DuckLocal, который мне задают, звучит примерно так: «почему просто не использовать DuckDB UI?»
Это справедливый вопрос. Оба инструмента запускают DuckDB локально, ни одному не нужен сервер, которым вы управляете, и оба хранят запросы и данные на вашем компьютере. Но они исходят из разных отправных точек, и это различие определяет, какой из них подходит для конкретной задачи. В этой статье я честно попытался это изложить — включая случаи, когда я сам выбрал бы DuckDB UI.
1. Короткий ответ
| Если вы… | Используйте |
|---|---|
| уже работаете в DuckDB CLI или Python и хотите визуально посмотреть на эту сессию | DuckDB UI |
| мыслите блокнотами из SQL-ячеек | DuckDB UI |
| используете MotherDuck или хотите делиться результатами через него | DuckDB UI |
| начинаете с груды CSV, Parquet, JSON или Excel-файлов и папок | DuckLocal |
| вам нужна работа офлайн или хотите, чтобы каждая часть инструмента была установлена и доступна для проверки | DuckLocal |
| хотите графики и дашборды, которые можно сохранить как файлы и держать в git | DuckLocal |
| хотите, чтобы ИИ-агент запрашивал те же данные из терминала | DuckLocal |
| хотите и то, и другое на одних и тех же данных | DuckLocal, затем CALL start_ui(); |
2. Что такое DuckDB UI
DuckDB UI создаёт и поддерживает MotherDuck, а поставляется он как расширение DuckDB под названием ui. Вы запускаете его командой duckdb -ui в терминале или вызовом CALL start_ui(); из любого клиента DuckDB — CLI, Python, Java и так далее.
Расширение поднимает HTTP-сервер на localhost (по умолчанию порт 4213) внутри процесса DuckDB, который его вызвал, и открывает ваш браузер. Поскольку интерфейс общается именно с этим процессом, он видит всё, что видит процесс: его подключённые базы данных, его память и ваши локальные файлы.
Что вы получаете в браузере:
- Блокноты — именованные сохранённые наборы SQL-ячеек с подсветкой синтаксиса и автодополнением. В одной ячейке может быть несколько операторов.
- Браузер подключённых баз данных со сводкой по таблице: число строк, столбцы, типы и профиль каждого столбца.
- Column Explorer, который обобщает результат и позволяет углубиться в каждый столбец.
- Необязательный вход в MotherDuck, чтобы сохранять таблицы в облачном хранилище MotherDuck и делиться ими. Это опция: по умолчанию ничего не покидает вашу машину.
Для сравнения важны две детали. Во-первых, локальный сервер расширения загружает собственные файлы фронтенда интерфейса с https://ui.duckdb.org, чтобы интерфейс оставался актуальным; ваши запросы по-прежнему выполняются локально, но сам интерфейс загружается из сети. Офлайн-использование на момент запуска не поддерживалось. Во-вторых, расширение распространяется по лицензии MIT, а исходный код фронтенда на момент запуска не был опубликован.
Источники: анонс DuckDB UI · документация расширения UI · duckdb/duckdb-ui на GitHub. Проверяйте их на изменения, сделанные после публикации этой статьи.
3. Сравнение по пунктам
| Критерий | DuckDB UI | DuckLocal |
|---|---|---|
| Что это | Браузерный блокнот, который отдаёт расширение ui в DuckDB | Нативное настольное приложение со встроенным DuckDB |
| Как запустить | duckdb -ui или CALL start_ui(); из любого клиента DuckDB (1.2.1 или новее) | Откройте приложение или выполните ducklocal ./data/ |
| Где выполняются запросы | В процессе DuckDB, который его запустил, на вашей машине | Во встроенном DuckDB внутри DuckLocal, на вашей машине |
| Файлы интерфейса | Загружаются локальным сервером с ui.duckdb.org | Поставляются вместе с приложением |
| Офлайн | Нужна сеть для файлов интерфейса | Работает офлайн; сеть используется только для S3, карт, установки расширений и проверок обновлений, которые вы включите |
| Загрузка данных | SQL: read_csv, ATTACH или то, что уже есть в сессии | Перетащите файлы, папки и шаблоны glob; они становятся представлениями и остаются при следующем запуске |
| Способ работы | Блокноты из SQL-ячеек | Вкладки запросов, боковая панель схемы, история, EXPLAIN и профайлер |
| Изучение результатов | Сводки по таблицам и Column Explorer | Сетка результатов, вкладка Overview по каждому столбцу и встроенные графики |
| Повторное использование и обмен | Сохранённые блокноты; необязательный обмен через MotherDuck | Текстовые дашборды .dash, которые можно проверять и держать в git, с комментариями к графикам |
| ИИ-агенты | Не в фокусе | CLI ducklocal с ограниченным по размеру JSON и официальным навыком для агентов |
| Исходный код | Расширение под MIT; фронтенд на момент запуска не опубликован | Apache-2.0, приложение и исходный код на GitHub |
| Платформы | Везде, где работает DuckDB, кроме windows_arm64 | macOS на Apple silicon, Windows x64, Linux x86_64 |
Самая короткая формулировка, которую я могу предложить: DuckDB UI — это окно в сессию DuckDB, которая у вас уже есть. DuckLocal — это сама сессия, построенная вокруг файлов, которые вы хотите посмотреть.
4. Когда использовать DuckDB UI
Вы уже живёте в DuckDB
Если ваша работа происходит в DuckDB CLI или в скрипте Python, интерфейс находится в одной команде от вас и не требует нового приложения. Выполните duckdb -ui my.duckdb или вызовите start_ui() из процесса Python, который уже загрузил и преобразовал ваши данные, и вы увидите ровно это состояние. DuckLocal не может заглянуть внутрь другого процесса; интерфейс для этого и создан.
Вы мыслите блокнотами
Иногда анализ — это длинная последовательность шагов, которую хочется сохранить по порядку: загрузить, очистить, соединить, проверить, обобщить. Блокноты с именованными сохранёнными ячейками хорошо подходят для этого, а одна ячейка может выполнить несколько операторов сразу. Вкладки запросов DuckLocal лучше подходят для множества отдельных вопросов, чем для длинного повествования.
Вы используете MotherDuck
Если ваша команда уже делится данными через MotherDuck, интерфейс — естественный фронтенд: войдите, и один и тот же блокнот доберётся и до локального DuckDB, и до вашего облачного хранилища. У DuckLocal нет облачного сервиса, и он не планируется.
Для вашей машины нет сборки DuckLocal
DuckLocal поставляется для macOS на Apple silicon, Windows x64 и Linux x86_64. На Intel Mac, например, вам пришлось бы собирать DuckLocal из исходников, тогда как DuckDB UI работает везде, где работает DuckDB (кроме Windows на ARM).
5. Когда использовать DuckLocal
Вы начинаете с файлов, а не с SQL
Перетащите CSV, папку с файлами Parquet или шаблон вроде ./logs/2026-*/*.json — и каждый из них станет представлением, которое можно запрашивать, а его столбцы появятся в боковой панели. Каждый непустой лист книги Excel становится таблицей. Ничего не нужно сначала писать как read_csv(…), и файлы остаются на месте при следующем открытии приложения.
Нужна работа офлайн или полная проверяемость
Интерфейс DuckLocal — часть установленного приложения. Он не загружает код интерфейса во время работы, не скачивает расширения самостоятельно, а проверки обновлений выключены, пока вы их не включите. Фронтенд DuckDB UI, напротив, загружается при запуске интерфейса и может читать данные, загруженные в DuckDB, — документация DuckDB сама советует указывать ему только URL, которому вы доверяете. Для большинства людей это нормально. Для проверок безопасности, аудитов, регулируемых данных или изолированных машин «всё установлено и открыто» — более сильная гарантия.
Вы хотите графики и дашборды в виде файлов
Результаты превращаются в столбчатые, линейные, точечные, круговые и картографические графики прямо на месте. Когда представление стоит сохранить, .dash-файл описывает его запросы, графики и фильтры как обычный текст — то, что можно сравнить через diff, проверить в pull request и провалидировать с помощью ducklocal check.
Вы работаете с ИИ-агентом
CLI ducklocal даёт агенту рабочий процесс SQL «сначала схема, один оператор» с ограниченным по размеру выводом JSON, а комментарии к дашбордам позволяют передать ему вопрос о конкретном графике. Те же файлы открыты в приложении, чтобы вы могли проверить его работу.
6. Запуск DuckDB UI внутри DuckLocal
Выбирать не обязательно. DuckDB UI — это расширение, а DuckLocal умеет загружать расширения DuckDB, поэтому интерфейс работает поверх собственного экземпляра DuckDB в DuckLocal:
- Откройте вкладку Extensions в боковой панели DuckLocal.
- Нажмите Install в строке
ui, затем Load. DuckLocal никогда не устанавливает расширения сам, так что этот шаг осознанный. - Во вкладке запроса выполните:
CALL start_ui();
Браузер откроет DuckDB UI по адресу http://localhost:4213. Он подключён к экземпляру DuckDB, который запущен в DuckLocal, поэтому файлы, открытые в DuckLocal, доступны в блокноте.
ui, загруженное на вкладке Extensions в DuckLocal. Отсюда CALL start_ui(); открывает DuckDB UI на том же экземпляре DuckDB.Несколько вещей, которые стоит знать:
- Нужна сеть: один раз для установки
uiи каждый раз при запуске, чтобы загрузить файлы интерфейса сui.duckdb.org. - Он завершается вместе с DuckLocal. Выход из DuckLocal закрывает его экземпляр DuckDB и сервер интерфейса вместе с ним.
CALL stop_ui_server();останавливает его раньше, аCALL start_ui_server();запускает без открытия браузера. - Блокноты принадлежат расширению и хранятся в
~/.duckdb/extension_data/ui/. История запросов DuckLocal не включает то, что вы выполняете в интерфейсе. - Он не может работать напрямую с базой данных только для чтения. Подключите такую базу из блокнота с помощью
ATTACH '…' (READ_ONLY).
Вот как я использую их вместе: DuckLocal — чтобы открыть данные, посмотреть на столбцы и построить графики по очевидным вопросам; DuckDB UI — когда один вопрос превращается в длинное исследование, которое я хочу сохранить как блокнот.
Документация: Открыть DuckDB UI из DuckLocal · Вкладка Extensions
7. Вопросы и ответы
Чем DuckDB UI отличается от DuckLocal?
DuckDB UI — это браузерный блокнот, который расширение ui в DuckDB отдаёт из того процесса DuckDB, который его запустил. DuckLocal — нативное настольное приложение со встроенным DuckDB, построенное вокруг открытия файлов и папок, графиков, текстовых дашбордов и CLI для ИИ-агентов. Оба выполняют запросы локально.
Заменяет ли DuckLocal DuckDB UI?
Нет. Они пересекаются в выполнении SQL по локальным данным, но интерфейс лучше всего работает как окно в существующую сессию DuckDB, а DuckLocal — как рабочее пространство для файлов. Поскольку интерфейс запускается внутри DuckLocal, вы можете использовать оба.
Работает ли DuckDB UI офлайн?
Ваши запросы выполняются локально, но файлы фронтенда интерфейса загружаются с ui.duckdb.org при каждом запуске, поэтому нужен доступ к сети. Интерфейс DuckLocal поставляется вместе с приложением и работает офлайн.
Отправляются ли мои запросы в MotherDuck?
Нет, если вы не войдёте в MotherDuck в интерфейсе. По умолчанию DuckDB UI выполняет ваши запросы на вашей собственной машине, как и DuckLocal.