---
title: "DuckDB UI или DuckLocal: какой локальный интерфейс DuckDB использовать"
description: "DuckDB UI — браузерный блокнот; DuckLocal — настольное рабочее пространство. Чем они отличаются, когда выбирать DuckDB UI и как запустить его внутри DuckLocal с помощью CALL start_ui()."
language: "ru"
---

# DuckDB UI или DuckLocal: что выбрать?

Оба инструмента дают DuckDB локальный интерфейс. Один — браузерный блокнот, который может открыть любой процесс DuckDB; другой — настольное рабочее пространство, построенное вокруг ваших файлов. Они отвечают разным задачам, и один можно запустить внутри другого.

![DuckDB UI против DuckLocal: утка DuckLocal за ноутбуком](https://ducklocal.app/assets/blog/duckdb-ui-vs-ducklocal-cover.webp)

В марте 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](https://duckdb.org/2025/03/12/duckdb-ui) · [документация расширения UI](https://duckdb.org/docs/current/core_extensions/ui.html) · [duckdb/duckdb-ui на GitHub](https://github.com/duckdb/duckdb-ui). Проверяйте их на изменения, сделанные после публикации этой статьи.

## 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`-файл](https://ducklocal.app/docs/ru/dashboards) описывает его запросы, графики и фильтры как обычный текст — то, что можно сравнить через diff, проверить в pull request и провалидировать с помощью `ducklocal check`.

### Вы работаете с ИИ-агентом

[CLI `ducklocal`](https://ducklocal.app/ru/use-cases/ai-agent-sql/) даёт агенту рабочий процесс SQL «сначала схема, один оператор» с ограниченным по размеру выводом JSON, а комментарии к дашбордам позволяют передать ему вопрос о конкретном графике. Те же файлы открыты в приложении, чтобы вы могли проверить его работу.

## 6. Запуск DuckDB UI внутри DuckLocal

Выбирать не обязательно. DuckDB UI — это расширение, а DuckLocal умеет загружать расширения DuckDB, поэтому интерфейс работает поверх собственного экземпляра DuckDB в DuckLocal:

- Откройте вкладку **Extensions** в боковой панели DuckLocal.

- Нажмите **Install** в строке `ui`, затем **Load**. DuckLocal никогда не устанавливает расширения сам, так что этот шаг осознанный.

- Во вкладке запроса выполните:

```text
CALL start_ui();
```

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

![Вкладка Extensions в DuckLocal с расширением ui в состоянии Loaded рядом с начальным экраном Drop your data in](https://ducklocal.app/assets/blog/ducklocal-extensions-ui.webp)

*Расширение `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](https://ducklocal.app/docs/ru/schema-and-history#duckdb-ui) · [Вкладка Extensions](https://ducklocal.app/docs/ru/schema-and-history#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.

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

- [Локальный интерфейс DuckDB (блог DuckDB)](https://duckdb.org/2025/03/12/duckdb-ui)

- [Документация расширения UI](https://duckdb.org/docs/current/core_extensions/ui.html)

- [Локальный анализ данных с DuckLocal](https://ducklocal.app/ru/use-cases/local-data-analysis/)

- [Чему Claude Dashboards научил меня о DuckLocal](https://ducklocal.app/ru/blog/claude-dashboards-ducklocal/)

[← Все записи](https://ducklocal.app/ru/blog/)

Source: https://ducklocal.app/ru/blog/duckdb-ui-vs-ducklocal/
