# Настройки и данные приложения

> Где DuckLocal хранит свои данные, что он запоминает, какие сетевые запросы может делать, размер интерфейса, тема и язык, а также как всё сбросить.

Source: https://ducklocal.app/docs/ru/settings-and-data

DuckLocal хранит один файл базы данных на диске, плюс небольшой файл, пока открыто окно, и файл журнала. Если вы включите онлайн-подложку карты, он также кэширует тайлы карты; загруженное обновление тоже ждёт в кэше. Всё остальное остаётся в памяти на время сеанса. Комментарии к дашбордам — исключение: они хранятся рядом с файлом дашборда, а не в каталоге данных приложения (см. [Проверка с комментариями](dashboards.md#review-with-comments)).

## Где хранятся данные {#where-things-are-stored}

| Платформа | Путь |
| --- | --- |
| macOS | `~/Library/Application Support/DuckLocal/history.duckdb` |
| Windows | `%APPDATA%\DuckLocal\data\history.duckdb` |
| Linux | `~/.local/share/ducklocal/history.duckdb` |

Файл DuckDB содержит четыре таблицы: история запросов, зарегистрированные файлы данных, базы данных, присоединённые рядом с открытой, и небольшая таблица настроек «ключ/значение». Настройки включают язык и размер интерфейса, открытые вкладки запросов и дашбордов, список недавних дашбордов, а также включены ли подложка карты и проверка обновлений. Пока приложение работает, рядом лежит сопутствующий файл `.wal` (журнал упреждающей записи DuckDB).

Ваши наборы данных никогда не копируются в базу данных приложения. Зарегистрированные файлы хранятся как пути к файлам и автоматически присоединяются заново при каждом запуске DuckLocal.

Рядом с ним, пока открыто окно, `gui-endpoint.json` содержит порт loopback и случайный токен, которые [`ducklocal open`](cli.md#show-work-in-the-running-window) использует, чтобы обратиться к окну. Прочитать его может только ваша учётная запись, а устаревший `gui-endpoint.json`, оставшийся от закрытого окна, безвреден.

Папка `logs` рядом с ним содержит журнал окна, `ducklocal.log` (и журнал предыдущего запуска, `ducklocal.previous.log`). Если DuckLocal аварийно завершается, он сначала записывает туда отчёт `crash-….log`, и следующий запуск сообщает, что произошло, с кнопкой **Показать отчёт**. Хранятся последние десять отчётов. Приложите отчёт, когда [создаёте issue](https://github.com/JetSquirrel/DuckLocal/issues). **Открыть папку журналов** открывает эту папку: она находится в меню **DuckLocal** на macOS и в контекстном меню версии в правом конце строки состояния на всех платформах. Команда `ducklocal` не пишет файл журнала; её ошибки попадают к тому, кто её вызвал.

Тайлы карты для [онлайн-подложки](#online-base-map) попадают в папку кэша платформы — `~/Library/Caches/DuckLocal/tiles` на macOS, `%LOCALAPPDATA%\DuckLocal\cache\tiles` на Windows, `~/.cache/ducklocal/tiles` на Linux — по одной папке на сервер тайлов. Удалить её безвредно — тайлы просто скачаются снова. Загруженное [обновление](#update-check) ждёт в `updates` в той же папке кэша, пока его не установят.

## Что сохраняется после перезапуска

| Запоминается | Где |
| --- | --- |
| Зарегистрированные файлы данных — путь, имя представления, тип | файл данных приложения |
| История запросов, включая неудачные | файл данных приложения |
| Язык интерфейса | файл данных приложения |
| Размер интерфейса | файл данных приложения |
| Был ли показан мастер первого запуска | файл данных приложения |
| Скрыта ли боковая панель | файл данных приложения |
| Базы данных, присоединённые рядом с открытой, и доступна ли каждая только для чтения | файл данных приложения |
| Файл базы данных, открытый последним | файл данных приложения — открывается снова при запуске, пока существует |
| Открытые вкладки запросов с их заголовками и SQL | файл данных приложения |
| Открытые вкладки дашбордов с их заголовками | файл данных приложения |
| Включена ли онлайн-подложка карты | файл данных приложения |
| Проверяет ли DuckLocal обновления при запуске | файл данных приложения |
| Недавно открытые дашборды (пункт **Дашборды** на боковой панели) | файл данных приложения |

| Не запоминается | Примечания |
| --- | --- |
| Содержимое панели результатов | только в памяти — выполните запрос заново |
| Таблицы и представления, созданные в базе данных в памяти | при выходе или открытии другой базы данных предлагается их сохранить; **Сохранить как базу данных…** записывает их в файл `.duckdb` |
| Файл базы данных, который с тех пор переместили или удалили | следующий запуск начинается с базы в памяти |
| Размер и положение окна | фиксированы: 1440×900, минимум 960×600 |
| Размеры боковой панели и панели результатов | фиксированы на каждый запуск |
| Фильтр результатов | только в памяти |
| Что выбрали фильтры дашборда | только в памяти; сохраняется при перезагрузке вкладки |
| **Тема** | всегда начинается со светлой — см. ниже |
| Учётные данные S3 | только на время сеанса, по замыслу |

Тема — особый случай: переключатель языка сохраняется, а переключатель темы нет, и каждый запуск начинается со светлого режима.

Обычный запуск работает в памяти, поэтому таблицы и представления, созданные там, исчезли бы вместе с окном. DuckLocal спрашивает до того, как это произойдёт: при выходе, закрытии окна или открытии другой базы данных, когда такие таблицы на месте, он предлагает **Сохранить как базу данных…**, **Выйти без сохранения** или **Отмена**. **Сохранить как базу данных…** (также ⌘⇧S или **Файл → Сохранить как базу данных…**) копирует схемы, таблицы и строки, представления, макросы и последовательности в файл `.duckdb` и переключает окно на него, так что последующие изменения записываются в файл; следующий запуск снова открывает этот файл. Представления, которые DuckLocal создаёт из зарегистрированных файлов, не учитываются — они создаются заново из файлов при каждом запуске.

## Сеть {#network}

DuckLocal не делает ни одного сетевого запроса сам по себе, пока вы его не включите. Есть два переключателя, оба изначально выключены, плюс то, что вы запрашиваете напрямую:

| Запрос | Когда | Что покидает машину |
| --- | --- | --- |
| [Онлайн-подложка карты](#online-base-map) | После включения — при каждой отрисовке карты | Какие тайлы нужны: примерно просматриваемая область и масштаб |
| [Проверка обновлений](#update-check) | При нажатии на версию или при запуске, если включена | Один запрос к `dl.ducklocal.app` за версией последнего выпуска; если есть более новый — загрузка его пакета |
| [S3](s3.md) | Когда вы настраиваете S3 и обращаетесь к нему | Ваши запросы к хранилищу, которое вы настроили |
| Расширения | При нажатии **Установить** или **Обновить** либо выполнении `INSTALL` | Загрузка из репозитория расширений DuckDB |
| Удалённые данные в SQL | Когда SQL указывает `https://`, `s3://` или удалённую базу данных, включая SQL дашборда при его открытии. Требуется уже установленное расширение | То, что запрашивает SQL, включая всё, что записано в адресе |

Телеметрии нет, и, кроме SQL, который вы выполняете, ничто из этого не отправляет ни строки ваших данных. SQL делает то, что написано: адрес может нести значения из ваших таблиц. Поэтому после установки `httpfs` файл `.dash` от того, кому вы не доверяете, может отправить данные при открытии. [Сеть и конфиденциальность](https://github.com/JetSquirrel/DuckLocal/blob/main/docs/network-and-privacy.md) перечисляет все пути и то, как проверить их самостоятельно.

## Онлайн-подложка карты {#online-base-map}

Графики-карты — в дашборде или на вкладке **График** в результатах — могут рисовать тайлы OpenStreetMap под своими точками. **Вид → Онлайн-подложка карты (OpenStreetMap)** включает и выключает её, и выбор запоминается (настройка `map_tiles`, `on` или `off`). Изначально она выключена. Машину покидают только запрошенные тайлы — примерно просматриваемая область и масштаб — но никогда ни одна строка данных.

Загрузка следует политике тайлов OpenStreetMap Foundation: идентифицирующий User-Agent, не более двух запросов одновременно, повторное использование тайлов из кэша в течение недели, без массовой предзагрузки, и атрибуция на карте. Для более интенсивного использования задайте в настройке `map_tile_url` шаблон URL `{z}/{x}/{y}` другого сервера.

## Проверка обновлений {#update-check}

Строка состояния заканчивается версией DuckLocal — `DuckLocal 0.3.0`. Нажмите на неё, чтобы проверить `dl.ducklocal.app` на наличие последнего выпуска:

- **Обновлено** — вы запускаете последнюю версию.
- **Загрузка v0.3.1…** — есть более новый выпуск, и DuckLocal загружает его. Пакет проверяется по опубликованным для выпуска размеру и SHA-256 — на macOS также по подписи приложения, которое вы запускаете — прежде чем его распакуют.
- **Перезапустите для обновления до v0.3.1** — новая версия готова. Нажмите, чтобы выйти, установить и открыть заново; иначе она установится при следующем выходе из DuckLocal.
- **Доступно обновление: v0.3.1** — более новый выпуск, который эта копия не может установить сама: сборка, которую вы скомпилировали, или приложение в папке, куда ему нельзя писать. Нажмите, чтобы загрузить пакет, и установите его так же, как устанавливали этот.
- **Не удалось проверить обновления** — наведите курсор, чтобы узнать причину (нет сети, прокси, загрузка не совпала с контрольной суммой); нажмите, чтобы повторить попытку.

Обновления приходят с `dl.ducklocal.app` — те же пакеты, что и в [выпуске на GitHub](https://github.com/JetSquirrel/DuckLocal/releases/latest), но с зеркала, которое быстро работает и в материковом Китае.

На macOS в меню **DuckLocal** есть та же проверка в виде **Проверить обновления…**, а также **Проверять обновления при запуске**, которая проверяет один раз при каждом старте приложения. Она выключена, пока вы её не включите (настройка `update_check`, `on` или `off`). До этого DuckLocal проверяет только по нажатию.

## Язык

Кнопка `EN` / `中` в строке заголовка сразу переключает язык интерфейса и запоминает выбор.

При первом запуске — до того, как сохранена хоть одна настройка — язык берётся из системной локали: `LC_ALL` или `LANG`, содержащие `zh`, выбирают китайский, всё остальное — английский. Нераспознанное сохранённое значение откатывается к китайскому.

Несколько строк намеренно не переводятся: `DuckLocal`, подписи кнопок `S3` и `EXPLAIN`, переключатель `EN` / `中` и заполнители учётных данных. Сообщения об ошибках движка и сети показываются дословно и всегда на английском, каким бы ни был язык интерфейса.

## Темы

Кнопка «солнце/луна» переключает светлую и тёмную тему. Выбора темы и файла темы для редактирования нет — есть только эти два режима.

## Размер интерфейса {#interface-size}

Текст, значки и элементы управления масштабируются вместе, в четыре шага:

| Размер | Базовый текст | Текст редактора |
| --- | --- | --- |
| Малый | 13px | 12px |
| По умолчанию | 14px | 13px |
| Большой | 16px | 15px |
| Очень большой | 18px | 17px |

Выберите один из них кнопкой **Aa** в строке заголовка или переключайтесь между ними с помощью **⌘+** (крупнее), **⌘−** (мельче) и **⌘0** (вернуться к значению по умолчанию) — они работают там, где сейчас фокус, включая редактор SQL. Выбор запоминается и сохраняется при переключении между светлой и тёмной темой.

Размеры панелей, которые вы перетащили, и высота графиков дашборда остаются в пикселях: их настраиваете вы, а не интерфейс.

## Сброс

Чтобы начать заново — очистив историю, зарегистрированные файлы, присоединённые базы данных, запомненные вкладки и все настройки — закройте DuckLocal и удалите каталог данных приложения:

```bash
rm -rf ~/Library/Application\ Support/DuckLocal   # macOS
rm -rf ~/.local/share/ducklocal                  # Linux
```

В Windows удалите `%APPDATA%\DuckLocal`.

Следующий запуск создаст его заново. **Ваши файлы данных при этом никогда не затрагиваются** — только собственные записи DuckLocal.

## Решение проблем

Симптомы, причины и исправления собраны на странице [Решение проблем](troubleshooting.md).
