Eine lediglich langsame Immich-Datenbank benötigt möglicherweise routinemäßige PostgreSQL-Wartung oder eine Ressourcenanpassung. Bei wiederholten Integritäts- oder Wiederherstellungsfehlern muss die Datenbank möglicherweise aus einem verifizierten Backup wiederhergestellt oder ersetzt werden.
Verwende „Datenbank neu erstellen“ nicht als allgemeine Lösung für Leistungsprobleme. Unterscheide zunächst zwischen normalem Wachstum, Bloat, veralteten Statistiken, blockierter Wartung und Speicherlatenz einerseits sowie Beschädigung oder einem nicht wiederherstellbaren Clusterzustand andererseits. Sichere vor eingreifenden Arbeiten einen Wiederherstellungspunkt, nimm jeweils nur eine Wartungsänderung vor und greife nur dann auf eine saubere Wiederherstellung zurück, wenn die vorliegenden Hinweise zeigen, dass der aktuellen Datenbank nicht zu trauen ist oder sie sich nicht sicher reparieren lässt.
Leistungsabfall von Integritätsproblemen unterscheiden
Beginne mit dem genauen Symptom: langsame Suchvorgänge, langsame Timeline-Abfragen, eine große Datenbank, hohe Festplattenaktivität, wiederholte PostgreSQL-Fehler, Schleifen bei der Absturzwiederherstellung oder eine Immich-Migration, die nicht abgeschlossen werden kann. Leistungssymptome und Integritätssymptome bergen unterschiedliche Risiken und sollten nicht mit derselben ersten Reparatur angegangen werden.
Vergewissere dich, dass der Host weiterhin über intakten Speicher und genügend freien Speicherplatz verfügt, sich der Arbeitsspeicher normal verhält und kein Immich-Hintergrundauftrag außer Kontrolle geraten ist, bevor du PostgreSQL die Schuld gibst. Ein ausgelastetes oder ausfallendes Laufwerk kann eine intakte Datenbank langsam erscheinen lassen und bei unzuverlässigem Speicher auch tatsächlich Datenbankschäden verursachen.
Sichere Protokolle, Datenbankversion, Erweiterungsversionen, den jüngsten Upgrade-Verlauf und ein Backup oder einen Snapshot, bevor du eingreifende Wartungsarbeiten durchführst. Wenn die einzige Datenbankkopie möglicherweise beschädigt ist, führe keine destruktive Bereinigung durch, nur um zu sehen, ob der Fehler danach verschwindet. Bewahre die Informationen auf, die für eine kontrollierte Entscheidung über die Wiederherstellung nötig sind.
Nach messbaren Anzeichen für Wartungsbedarf suchen
Regelmäßige Wartung ist ein plausibler Ansatz, wenn die Datenbank startet und intern weiterhin nutzbar ist, sich aber die Abfrageleistung oder der Speicherbedarf mit der Zeit verschlechtert. Aussagekräftige Hinweise sind beispielsweise eine zunehmende Zahl veralteter Zeilen, Tabellen oder Indizes, die überproportional wachsen, ein Autovacuum, das nicht mehr hinterherkommt, veraltete Planerstatistiken oder lang laufende Wartungsarbeiten, die durch andere Sitzungen blockiert werden.
Tote Tupel, Aufblähung, Druck durch das Einfrieren von Transaktions-IDs, blockiertes VACUUM und eine unzureichende Häufigkeit von VACUUM können sich auf die Wartung und Abfrageleistung von PostgreSQL auswirken. Nutzen Sie VACUUM-Signale auf Tabellenebene über einen längeren Zeitraum, statt allein aus einer großen Datenbankdatei zu schließen, dass die Datenbank ersetzt werden muss.
Wenn Statistiken auf eine bestimmte Tabelle oder einen Index hindeuten, wählen Sie für diesen Befund die am wenigsten invasive, unterstützte Wartungsmaßnahme und messen Sie anschließend erneut. Greifen Sie nicht sofort zu VACUUM FULL, umfassenden REINDEX-Vorgängen oder willkürlichen Autovacuum-Einstellungen für den gesamten Cluster. Diese Maßnahmen können Sperren, I/O-Last oder zusätzlichen Speicherbedarf verursachen und beheben möglicherweise nicht den tatsächlichen Engpass.
Prüfen, ob Aufblähung oder Indexwachstum mit dem langsamen Vorgang zusammenhängt
Vergleichen Sie die an langsamen Immich-Vorgängen beteiligten Objekte mit der Größe von Tabellen und Indizes, der Änderungshäufigkeit von Zeilen und dem Abfrageverhalten. Aufblähung ist relevant, wenn sie den Aufwand für das Auffinden nützlicher Zeilen erhöht oder Indizes weniger effektiv macht. Die Datenbank kann aber auch einfach deshalb groß sein, weil die Bibliothek und die Metadaten umfangreich sind.
Die Aufblähung von Tabellen und Indizes sollte getrennt bewertet werden, da übermäßige Aufblähung den Abfrageaufwand erhöhen kann, ohne auf eine Beschädigung der Datenbank hinzudeuten. Nutzen Sie Messungen der PostgreSQL-Aufblähung, um ein beobachtetes Objekt gezielt zu prüfen, und aktualisieren Sie bei Bedarf die Planerstatistiken, statt die Gesamtgröße der Datenbank als Diagnose zu betrachten.
Führen Sie nach der Wartung dieselbe Immich-Aktion, die zuvor langsam war, erneut aus und vergleichen Sie sowohl die für Benutzer wahrnehmbare Latenz als auch das Verhalten von Datenbank und Speicher. Verbessert sich der Vorgang nicht, setzen Sie die vorherige Optimierung nach Möglichkeit zurück und untersuchen Sie Speicher, Abfragemuster, Hintergrundaufgaben oder Ursachen auf Anwendungsebene, statt weitere Datenbankänderungen vorzunehmen.
Auf Wiederherstellung oder Ersatz umsteigen, wenn die Integrität ungewiss ist
Ein Austausch ist gerechtfertigt, wenn es Belege dafür gibt, dass dem aktuellen PostgreSQL-Zustand nicht vertraut werden kann oder er sich nicht sicher wiederherstellen lässt, nicht allein wegen seines Alters. Beispiele sind wiederholt auftretende Seiten- oder Prüfsummenbeschädigungen, Start- oder Wiederherstellungsfehler, die trotz intaktem Speicher bestehen bleiben, ein beschädigter Cluster nach einem unvollständigen Speicherereignis oder ein Migrationszustand, der sich nicht über den unterstützten Weg reparieren lässt.
Bevor Sie die Datenbank als verloren betrachten, weisen Sie nach, dass sich eine bekanntermaßen intakte Sicherung in einer sauberen, kompatiblen PostgreSQL-Umgebung wiederherstellen lässt und Immich sie lesen kann. Wenn die saubere Wiederherstellung funktioniert, während der aktuelle Cluster denselben Integritätsfehler wiederholt, haben Sie eine deutlich bessere Grundlage dafür, den Datenbankzustand zu ersetzen, statt weiter an Ort und Stelle zu reparieren.
Reparieren Sie lokale, reversible Fehler und erhalten Sie dabei unsichere persistente Daten. Setzen Sie das System nur dann neu auf, wenn die Wiederherstellungsquelle überprüft wurde und das Ziel reproduzierbar ist. Wenden Sie diese Abgrenzung zwischen Reparatur und Neuaufsetzen von Immich auch auf die Datenbank an. „Austausch“ sollte bedeuten, einen kompatiblen PostgreSQL-Zustand aus einer bekanntermaßen intakten Quelle wiederherzustellen, und nicht, die Datenbank zu wechseln, weil eine Abfrage langsam geworden ist.
Datenbank anhand von Lese-, Schreib- und Sicherungsvorgängen überprüfen
Unabhängig davon, ob Sie Wartungsarbeiten durchgeführt oder eine saubere Datenbank wiederhergestellt haben: Überprüfen Sie das Ergebnis in Immich, statt es bei einem erfolgreichen PostgreSQL-Start zu belassen. Öffnen Sie alte Alben und Assets, führen Sie Suchvorgänge aus, laden Sie repräsentative Videos und prüfen Sie, ob Benutzer und Freigaben wie erwartet angezeigt werden.
Führen Sie einen sicheren neuen Schreibvorgang aus, beispielsweise indem Sie ein entbehrliches Asset hochladen, und bestätigen Sie, dass es nach einem normalen Neustart des Dienstes weiterhin zugänglich ist. Überwachen Sie die PostgreSQL- und Immich-Protokolle auf wiederkehrende Integritäts-, Migrations-, Erweiterungs- oder Berechtigungsfehler, während Lese- und Schreibvorgänge aktiv sind.
Erstellen Sie abschließend mit Ihrer üblichen Methode eine aktuelle Datenbanksicherung und testen Sie nach Möglichkeit die Wiederherstellung auf einem isolierten Zielsystem. Die Wartungs- oder Austauschentscheidung ist erst dann abgeschlossen, wenn das aktuelle System nutzbar ist und der nächste Wiederherstellungspunkt nachweislich in einem besseren Zustand ist als der Zustand, der den Vorfall ausgelöst hat.
Support und Tipps
Mehr zum Lesen

So halten Sie Erwachsenenvideos auf Ihrem NAS vor Familienmitgliedern verborgen
Bewahre Videos für Erwachsene auf einem Familien-NAS privat auf. Prüfe Ordnerberechtigungen, den Bibliothekszugriff in Plex und Jellyfin, Vorschaubilder, den Wiedergabeverlauf, gemeinsam genutzte TV-Logins und...

Was vor dem Laden eines Community-Modells in Transformers zu beachten ist
Nutze das Transformers-Jinja-Sandbox-Update, um die Herkunft des Modells, Chat-Vorlagen, Remote-Code, serialisierte Gewichte und isolierte erste Ausführungen zu überprüfen.

Mirage lokal ausführen: OCR und Objekterkennung aus einem einzigen Bild
Testen Sie das kleine lokale Vision-Modell von Cactus Compute, überprüfen Sie die OCR- und Objektextraktion anhand realer Eingaben und verstehen Sie die Grenzen in...



