SQLite-Wartung: ANALYZE, VACUUM und die WAL-Datei #

Diese Seite richtet sich an Datenbankadministratoren, die eine Exponential-Website auf SQLite betreuen. Sie beantwortet: welche Wartung SQLite braucht, wann jede Aufgabe läuft, wie Sie sie ausführen, ohne Redakteure zu stören, und wie eine gesunde Ausgabe aussieht. Quelle: ANALYZE, VACUUM und die WAL-Datei und Eine SQLite-Website überwachen. Das Kommandozeilenprogramm sqlite3 ist für die Website optional, für diese Aufgaben aber nötig (sqlite3 --version).

Inhalt #

1. Statistiken: ANALYZE
2. Verdichtung: VACUUM
3. Die WAL-Datei
4. Integritätsprüfungen
5. Ein Wartungsplan
6. Checkliste

Die Beispiele verwenden var/storage/sqlite3/exponential.db; verwenden Sie die Datei, die Ihre Einstellung Database nennt.

Statistiken: ANALYZE #

Der Abfrageplaner von SQLite wählt Indizes mit Statistiken besser. Führen Sie ANALYZE einmal nach einer Installation oder einem großen Import aus und erneut, nachdem die Inhalte stark gewachsen sind:

sqlite3 var/storage/sqlite3/exponential.db "ANALYZE"

Einer Website, die direkt nach einer Installation oder einem Import langsam ist, fehlen sie meist (12.10). PRAGMA optimize führt nur die nötige Analyse aus und ist günstig genug für einen wöchentlichen Cron-Eintrag:

sqlite3 var/storage/sqlite3/exponential.db "PRAGMA optimize"

Verdichtung: VACUUM #

Gelöschte Inhalte hinterlassen freie Seiten in der Datei. SQLite verwendet sie wieder, gibt sie aber nicht an das Dateisystem zurück. VACUUM baut die Datei kompakt neu auf. Es braucht etwa die doppelte Größe der Datenbank an freiem Speicherplatz und hält die Schreibsperre während seines ganzen Laufs, Schreiber reihen sich also dahinter ein und können nach SQLiteTransactionWait in ein Timeout laufen. Führen Sie es im Wartungsmodus aus, und nur, wenn die Datei viel größer geworden ist als ihr Inhalt (nachdem ein großer Teil der Website entfernt wurde):

php bin/php/maintenance.php on --allow-root-user
sqlite3 var/storage/sqlite3/exponential.db "VACUUM"
php bin/php/maintenance.php off --allow-root-user

VACUUM INTO '<file>' schreibt stattdessen eine verdichtete Kopie und ist eine gute Sicherungsmethode (Sicherungen je Engine).

Die WAL-Datei #

Nach einem Checkpoint verwendet SQLite die WAL-Datei von ihrem Anfang an wieder, verkleinert sie aber nicht. Ein Schub starker Schreibzugriffe kann eine große -wal-Datei hinterlassen; in den Lasttests des Projekts wuchs sie auf weit über hundert Megabyte und wurde danach per Checkpoint zurückgeführt. Zwei Abhilfen:

• In settings/override/site.ini.append.php kürzt SQLitePragmas[]=journal_size_limit=67108864 das WAL nach jedem Checkpoint, der es leert, auf 64 MB.

• Ein manueller Checkpoint, der die Datei kürzt:

  sqlite3 var/storage/sqlite3/exponential.db "PRAGMA wal_checkpoint(TRUNCATE)"

  Er gibt drei Zahlen aus; eine erste Zahl 0 bedeutet, dass der Checkpoint nicht blockiert wurde.

Löschen Sie nie die Datei -wal oder -shm, solange ein Prozess die Datenbank geöffnet hat: Sie gehören zur Datenbank.

Integritätsprüfungen #

Führen Sie dieselbe Integritätsprüfung auf jeder Sicherung aus, bevor Sie sich auf sie verlassen.

Ein Wartungsplan #

Führen Sie Cron-Einträge mit derselben Gruppe und einer Umask von 0002 aus wie die Website, damit von ihnen angelegte Dateien für die Gruppe schreibbar bleiben (SQLite-Dateien, Eigentümer und Rechte). exp:benchmark kernel misst unter seinen Proben den Weg zur Datenbank und zurück; mit --save und --baseline erkennt es eine Verlangsamung zwischen zwei Läufen (Benchmark).

Checkliste #

• To do: ANALYZE wurde nach der Installation und nach großen Importen ausgeführt.
• To do: Ein wöchentliches PRAGMA optimize und quick_check sind eingeplant.
• To do: VACUUM läuft nur im Wartungsmodus, mit genug freiem Speicherplatz.
• To do: Die Datei -wal wächst nach Lastspitzen nicht immer weiter.

Verwandte Seiten #

• SQLite 3 für Datenbankadministratoren
• SQLite: die Schreibwarteschlange und Sperren
• Die Datenbank überwachen
• Wartungsmodus
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.