Перейти к содержимому

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

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 / 中 и заполнители учётных данных. Сообщения об ошибках движка и сети показываются дословно и всегда на английском, каким бы ни был язык интерфейса.

Темы ​

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

Размер интерфейса ​

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

РазмерБазовый текстТекст редактора
Малый13px12px
По умолчанию14px13px
Большой16px15px
Очень большой18px17px

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

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

Сброс ​

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

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

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

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

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

Симптомы, причины и исправления собраны на странице Решение проблем.

Опубликовано под лицензией Apache-2.0.