Консистентный бэкап SQLite
Копирует SQLite через backup API, проверяет integrity_check и считает SHA-256.
Что делает скрипт
Скрипт открывает базу в режиме только для чтения и создаёт новый файл через встроенный backup API, поэтому копия согласована даже при активных записях. После копирования выполняется pragma integrity_check. Существующий файл результата не перезаписывается.
- Во время копирования не удаляйте файлы журналов SQLite.
Быстрый старт
python backup_sqlite.py --database ./app.db --dest /mnt/backup/sqlite
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python backup_sqlite.py --database ./app.db --dest /mnt/backup/sqlitepython backup_sqlite.py --database ./app.db --dest /mnt/backup/sqlite --dry-run
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
backup_sqlite.py
#!/usr/bin/env python3
"""Консистентная копия SQLite через backup API."""
from __future__ import annotations
import argparse
import hashlib
import sqlite3
import sys
import time
from pathlib import Path
def file_digest(path: Path, chunk_size: int = 1024 * 1024) -> str:
digest = hashlib.sha256()
with path.open("rb") as handle:
while block := handle.read(chunk_size):
digest.update(block)
return digest.hexdigest()
def main() -> int:
parser = argparse.ArgumentParser(description="Создать копию базы SQLite")
parser.add_argument("--database", type=Path, required=True)
parser.add_argument("--dest", type=Path, required=True)
parser.add_argument("--dry-run", action="store_true")
args = parser.parse_args()
source = args.database.expanduser().resolve()
dest = args.dest.expanduser().resolve()
if not source.is_file():
parser.error(f"База не найдена: {source}")
if dest == source:
parser.error("База и каталог назначения совпадают")
timestamp = time.strftime("%Y%m%d-%H%M%S")
target = dest / f"{source.stem}-{timestamp}.sqlite"
if target.exists():
parser.error(f"Файл уже существует: {target}")
if args.dry_run:
print(f"Будет создано: {target}")
return 0
dest.mkdir(parents=True, exist_ok=True)
source_conn = sqlite3.connect(source.as_uri() + "?mode=ro", uri=True)
target_conn = sqlite3.connect(target)
try:
source_conn.backup(target_conn)
check = target_conn.execute("PRAGMA integrity_check").fetchone()
if not check or check[0] != "ok":
raise RuntimeError("integrity_check не прошёл")
except Exception as error:
target_conn.close()
source_conn.close()
target.unlink(missing_ok=True)
print(f"Ошибка копирования: {error}", file=sys.stderr)
return 1
target_conn.close()
source_conn.close()
print(f"Создана копия: {target}")
print(f"Размер: {target.stat().st_size} байт")
print(f"SHA-256: {file_digest(target)}")
return 0
if __name__ == "__main__":
sys.exit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.