В марте 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
хотите графики и дашборды, которые можно сохранить как файлы и держать в gitDuckLocal
хотите, чтобы ИИ-агент запрашивал те же данные из терминала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 UIDuckLocal
Что этоБраузерный блокнот, который отдаёт расширение 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_arm64macOS на 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:

  1. Откройте вкладку Extensions в боковой панели DuckLocal.
  2. Нажмите Install в строке ui, затем Load. DuckLocal никогда не устанавливает расширения сам, так что этот шаг осознанный.
  3. Во вкладке запроса выполните:
CALL start_ui();

Браузер откроет DuckDB UI по адресу http://localhost:4213. Он подключён к экземпляру DuckDB, который запущен в DuckLocal, поэтому файлы, открытые в DuckLocal, доступны в блокноте.

Вкладка Extensions в DuckLocal с расширением ui в состоянии Loaded рядом с начальным экраном Drop your data in
Расширение 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.

Полезные ссылки

← Все записи