Всё — это файл

функциональный

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

Подключения, история запросов, сниппеты, карточки сущностей, сочетания клавиш и правила — всё это живёт как обычных файлов на диске. Никакой непрозрачной служебной базы, из которой потом пришлось бы «выбираться»: делайте резервные копии, сравнивайте их или держите в Git, если так удобнее.

Где они находятся

Всё хранится в одной SQLLY папке в стандартных местах конфигурации и данных вашей платформы:

ПлатформаПапка
macOS~/Library/Application Support/SQLLY/
Windows%APPDATA%\SQLLY\ и %LOCALAPPDATA%\SQLLY\
Linux~/.config/SQLLY/ и ~/.local/share/SQLLY/

Несколько файлов, которые вы там найдете:

  • connections.json - ваши подключения и клиенты, проекты и среды, к которым они относятся, — с их цветами и политикой безопасности. Никогда никаких паролей (см. ниже).
  • keybindings.json - ваш keymap, правится вручную.
  • intellisense-rules.jsonc - правила автодополнения, с разрешёнными комментариями, потому что файл правил, который нельзя аннотировать, — это файл правил, который вы не станете поддерживать.
  • entra-accounts.json, query-ai-summary.json, cli-agent.json - настройки каждой функции — в отдельном файле, поэтому сброс — это удаление, а не хирургическая операция.
  • Папки для истории запросов, бесед с ИИ, предложений и аудита MCP, а также временных файлов выгрузки результатов.
Секреты — намеренное исключение. Пароли и токены сохраняются в связке ключей операционной системы (macOS Keychain, Windows Credential Manager, Linux Secret Service), а JSON хранит только ссылку на них. Именно поэтому файл подключения можно спокойно копировать, сравнивать и коммитить: учётных данных в нём нет.

Версионированные файлы настроек

connections.json, tenant-scoping.json, и все остальные файлы настроек записывают версию конфигурации, с которой они были сохранены. Когда SQLly запускается и находит файл, сохранённый более старой версией, он один раз обновляет его и сохраняет в текущей версии. В этом выпуске обновление очищает настройки привязки к арендатору (tenant scoping), сохранённые более ранними версиями (см. Ограничение по арендатору). Вам ничего делать не нужно.

Почему выбран такой формат

  • Вы можете уйти. Ваши настройки читаются без SQLly и переносятся с помощью cp.
  • Всё можно просмотреть. Изменение подключения или раскладки клавиш видно как читаемый дифф — единственный вид изменений конфигурации, который приживается в команде.
  • Всё можно исправить. Когда что-то идёт не так, это файл, который можно открыть, а не база данных, для которой нужен тикет в поддержку.
  • Синхронизация — не наша проблема. Поскольку это просто файлы, работает любой инструмент синхронизации файлов, и нам не нужно быть в середине этого процесса.