Настройки и данные приложения
DuckLocal хранит один файл базы данных на диске, плюс небольшой файл, пока открыто окно, и файл журнала. Если вы включите онлайн-подложку карты, он также кэширует тайлы карты; загруженное обновление тоже ждёт в кэше. Всё остальное остаётся в памяти на время сеанса. Комментарии к дашбордам — исключение: они хранятся рядом с файлом дашборда, а не в каталоге данных приложения (см. Проверка с комментариями).
Где хранятся данные
| Платформа | Путь |
|---|---|
| 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 использует, чтобы обратиться к окну. Прочитать его может только ваша учётная запись, а устаревший gui-endpoint.json, оставшийся от закрытого окна, безвреден.
Папка logs рядом с ним содержит журнал окна, ducklocal.log (и журнал предыдущего запуска, ducklocal.previous.log). Если DuckLocal аварийно завершается, он сначала записывает туда отчёт crash-….log, и следующий запуск сообщает, что произошло, с кнопкой Показать отчёт. Хранятся последние десять отчётов. Приложите отчёт, когда создаёте issue. Открыть папку журналов открывает эту папку: она находится в меню DuckLocal на macOS и в контекстном меню версии в правом конце строки состояния на всех платформах. Команда ducklocal не пишет файл журнала; её ошибки попадают к тому, кто её вызвал.
Тайлы карты для онлайн-подложки попадают в папку кэша платформы — ~/Library/Caches/DuckLocal/tiles на macOS, %LOCALAPPDATA%\DuckLocal\cache\tiles на Windows, ~/.cache/ducklocal/tiles на Linux — по одной папке на сервер тайлов. Удалить её безвредно — тайлы просто скачаются снова. Загруженное обновление ждёт в updates в той же папке кэша, пока его не установят.
Что сохраняется после перезапуска
| Запоминается | Где |
|---|---|
| Зарегистрированные файлы данных — путь, имя представления, тип | файл данных приложения |
| История запросов, включая неудачные | файл данных приложения |
| Язык интерфейса | файл данных приложения |
| Размер интерфейса | файл данных приложения |
| Был ли показан мастер первого запуска | файл данных приложения |
| Скрыта ли боковая панель | файл данных приложения |
| Базы данных, присоединённые рядом с открытой, и доступна ли каждая только для чтения | файл данных приложения |
| Файл базы данных, открытый последним | файл данных приложения — открывается снова при запуске, пока существует |
| Открытые вкладки запросов с их заголовками и SQL | файл данных приложения |
| Открытые вкладки дашбордов с их заголовками | файл данных приложения |
| Включена ли онлайн-подложка карты | файл данных приложения |
| Проверяет ли DuckLocal обновления при запуске | файл данных приложения |
| Недавно открытые дашборды (пункт Дашборды на боковой панели) | файл данных приложения |
| Не запоминается | Примечания |
|---|---|
| Содержимое панели результатов | только в памяти — выполните запрос заново |
| Таблицы и представления, созданные в базе данных в памяти | при выходе или открытии другой базы данных предлагается их сохранить; Сохранить как базу данных… записывает их в файл .duckdb |
| Файл базы данных, который с тех пор переместили или удалили | следующий запуск начинается с базы в памяти |
| Размер и положение окна | фиксированы: 1440×900, минимум 960×600 |
| Размеры боковой панели и панели результатов | фиксированы на каждый запуск |
| Фильтр результатов | только в памяти |
| Что выбрали фильтры дашборда | только в памяти; сохраняется при перезагрузке вкладки |
| Тема | всегда начинается со светлой — см. ниже |
| Учётные данные S3 | только на время сеанса, по замыслу |
Тема — особый случай: переключатель языка сохраняется, а переключатель темы нет, и каждый запуск начинается со светлого режима.
Обычный запуск работает в памяти, поэтому таблицы и представления, созданные там, исчезли бы вместе с окном. DuckLocal спрашивает до того, как это произойдёт: при выходе, закрытии окна или открытии другой базы данных, когда такие таблицы на месте, он предлагает Сохранить как базу данных…, Выйти без сохранения или Отмена. Сохранить как базу данных… (также ⌘⇧S или Файл → Сохранить как базу данных…) копирует схемы, таблицы и строки, представления, макросы и последовательности в файл .duckdb и переключает окно на него, так что последующие изменения записываются в файл; следующий запуск снова открывает этот файл. Представления, которые DuckLocal создаёт из зарегистрированных файлов, не учитываются — они создаются заново из файлов при каждом запуске.
Сеть
DuckLocal не делает ни одного сетевого запроса сам по себе, пока вы его не включите. Есть два переключателя, оба изначально выключены, плюс то, что вы запрашиваете напрямую:
| Запрос | Когда | Что покидает машину |
|---|---|---|
| Онлайн-подложка карты | После включения — при каждой отрисовке карты | Какие тайлы нужны: примерно просматриваемая область и масштаб |
| Проверка обновлений | При нажатии на версию или при запуске, если включена | Один запрос к dl.ducklocal.app за версией последнего выпуска; если есть более новый — загрузка его пакета |
| S3 | Когда вы настраиваете S3 и обращаетесь к нему | Ваши запросы к хранилищу, которое вы настроили |
| Расширения | При нажатии Установить или Обновить либо выполнении INSTALL | Загрузка из репозитория расширений DuckDB |
| Удалённые данные в SQL | Когда SQL указывает https://, s3:// или удалённую базу данных, включая SQL дашборда при его открытии. Требуется уже установленное расширение | То, что запрашивает SQL, включая всё, что записано в адресе |
Телеметрии нет, и, кроме SQL, который вы выполняете, ничто из этого не отправляет ни строки ваших данных. SQL делает то, что написано: адрес может нести значения из ваших таблиц. Поэтому после установки httpfs файл .dash от того, кому вы не доверяете, может отправить данные при открытии. Сеть и конфиденциальность перечисляет все пути и то, как проверить их самостоятельно.
Онлайн-подложка карты
Графики-карты — в дашборде или на вкладке График в результатах — могут рисовать тайлы OpenStreetMap под своими точками. Вид → Онлайн-подложка карты (OpenStreetMap) включает и выключает её, и выбор запоминается (настройка map_tiles, on или off). Изначально она выключена. Машину покидают только запрошенные тайлы — примерно просматриваемая область и масштаб — но никогда ни одна строка данных.
Загрузка следует политике тайлов OpenStreetMap Foundation: идентифицирующий User-Agent, не более двух запросов одновременно, повторное использование тайлов из кэша в течение недели, без массовой предзагрузки, и атрибуция на карте. Для более интенсивного использования задайте в настройке map_tile_url шаблон URL {z}/{x}/{y} другого сервера.
Проверка обновлений
Строка состояния заканчивается версией 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, но с зеркала, которое быстро работает и в материковом Китае.
На macOS в меню DuckLocal есть та же проверка в виде Проверить обновления…, а также Проверять обновления при запуске, которая проверяет один раз при каждом старте приложения. Она выключена, пока вы её не включите (настройка update_check, on или off). До этого DuckLocal проверяет только по нажатию.
Язык
Кнопка EN / 中 в строке заголовка сразу переключает язык интерфейса и запоминает выбор.
При первом запуске — до того, как сохранена хоть одна настройка — язык берётся из системной локали: LC_ALL или LANG, содержащие zh, выбирают китайский, всё остальное — английский. Нераспознанное сохранённое значение откатывается к китайскому.
Несколько строк намеренно не переводятся: DuckLocal, подписи кнопок S3 и EXPLAIN, переключатель EN / 中 и заполнители учётных данных. Сообщения об ошибках движка и сети показываются дословно и всегда на английском, каким бы ни был язык интерфейса.
Темы
Кнопка «солнце/луна» переключает светлую и тёмную тему. Выбора темы и файла темы для редактирования нет — есть только эти два режима.
Размер интерфейса
Текст, значки и элементы управления масштабируются вместе, в четыре шага:
| Размер | Базовый текст | Текст редактора |
|---|---|---|
| Малый | 13px | 12px |
| По умолчанию | 14px | 13px |
| Большой | 16px | 15px |
| Очень большой | 18px | 17px |
Выберите один из них кнопкой Aa в строке заголовка или переключайтесь между ними с помощью ⌘+ (крупнее), ⌘− (мельче) и ⌘0 (вернуться к значению по умолчанию) — они работают там, где сейчас фокус, включая редактор SQL. Выбор запоминается и сохраняется при переключении между светлой и тёмной темой.
Размеры панелей, которые вы перетащили, и высота графиков дашборда остаются в пикселях: их настраиваете вы, а не интерфейс.
Сброс
Чтобы начать заново — очистив историю, зарегистрированные файлы, присоединённые базы данных, запомненные вкладки и все настройки — закройте DuckLocal и удалите каталог данных приложения:
rm -rf ~/Library/Application\ Support/DuckLocal # macOS
rm -rf ~/.local/share/ducklocal # LinuxВ Windows удалите %APPDATA%\DuckLocal.
Следующий запуск создаст его заново. Ваши файлы данных при этом никогда не затрагиваются — только собственные записи DuckLocal.
Решение проблем
Симптомы, причины и исправления собраны на странице Решение проблем.
