SQLite VACUUM INTO: сделать компактную копию

Категория: Postgresql · Язык: SQL · Обновлено:

VACUUM INTO создаёт новый файл базы с теми же данными, но без свободных страниц и фрагментации. Это удобный способ сделать компактную резервную копию или подготовить базу к переносу. Команда появилась в SQLite 3.27 и не изменяет исходный файл.

Создать компактную копию

SQL
CREATE TABLE notes (
    id INTEGER PRIMARY KEY,
    body TEXT NOT NULL
);

INSERT INTO notes (body) VALUES ('первая'), ('вторая');

VACUUM INTO 'backup.db';

Целевой файл должен отсутствовать: если backup.db уже есть, команда завершится ошибкой. Путь относителен рабочему каталогу процесса, а не расположению исходной базы. После завершения откройте копию отдельным соединением и проверьте PRAGMA integrity_check;.

VACUUM INTO создаёт согласованный снимок на момент начала операции, но не заменяет резервное копирование с учётом WAL. Если база работает в режиме WAL, незакоммиченные изменения в журнал не попадут, а уже закоммиченные — попадут. Для горячей копии с непрерывной записью используйте sqlite3_backup API или .backup, которые учитывают журнал.

Команда требует свободного места примерно в размер базы и может быть долгой на больших файлах. Не запускайте её в транзакции: VACUUM и VACUUM INTO нельзя выполнять внутри BEGIN. Для замены рабочей базы остановите писателей, сделайте копию, проверьте её и только потом переименовывайте файлы.

Копия не сохраняет настройки PRAGMA соединения, временные таблицы и данные, которые ещё не закоммичены. Пароли и шифрование задаются на уровне приложения/SQLCipher и в обычный файл не попадут. Не публикуйте backup-файл в веб-корне: он содержит все данные базы.

Документация: VACUUM, backup API.