Миграции и резервные копии базы данных

На этой странице описано, как dinary-server управляет DuckDB-файлами и как безопасно делать их резервные копии.

Файлы базы данных

Сервер хранит данные в директории data/:

config.duckdb - справочные данные: категории, группы, теги, магазины и mapping-таблицы
budget_YYYY.duckdb - транзакционные данные за год: расходы и задания синхронизации

Изменения схемы управляются через миграции yoyo.

При старте приложения config.duckdb автоматически мигрируется до последней версии
При первом открытии годовой базы budget_YYYY.duckdb она автоматически создается и мигрируется
Во время inv deploy deploy-скрипт применяет миграции config.duckdb до перезапуска сервиса

Для новой установки ручной шаг миграции обычно не нужен.

Если вы хотите применить миграции явно на сервере:

inv migrate-config
inv migrate-budget --year=2026

Используйте migrate-budget для любого года, чей файл budget_YYYY.duckdb уже существует или должен быть создан заранее.

DuckDB хранит данные в локальных файлах, поэтому резервное копирование здесь файловое.

Сохраняйте всю директорию data/, включая:

Создавайте резервную копию:

Чтобы скачать данные сервера локально:

inv backup

По умолчанию команда копирует удаленную директорию data/ в ./backups/.

Можно указать другой путь:

inv backup --dest=./my-backups

Чтобы восстановиться из backup:

Остановите работающий сервис
Замените содержимое data/ файлами из резервной копии
Запустите сервис снова
Выполните inv migrate-config и inv migrate-budget --year=YYYY, если хотите принудительно проверить миграции после восстановления

Так как база файловая, восстановление обычно сводится к копированию файлов.

Держите как минимум одну резервную копию перед каждым деплоем
Считайте data/ источником истины
Не редактируйте DuckDB-файлы, пока сервис активно в них пишет
Если копируете файлы вручную, предпочтительно делать это при остановленном сервисе