Une base de données Immich simplement lente peut nécessiter une maintenance PostgreSQL de routine ou une correction des ressources ; une base de données qui présente des défaillances répétées d’intégrité ou de récupération peut nécessiter une restauration ou un remplacement à partir d’une sauvegarde vérifiée.
N’utilisez pas « reconstruire la base de données » comme solution générique aux problèmes de performance. Commencez par distinguer la croissance normale, le gonflement, les statistiques obsolètes, les opérations de maintenance bloquées et la latence du stockage de la corruption ou d’un état de cluster irrécupérable. Créez un point de récupération avant toute intervention intrusive, évaluez les effets d’une seule modification de maintenance à la fois et optez pour une restauration propre uniquement lorsque les éléments montrent que la base de données actuelle n’est pas fiable ou ne peut pas être réparée en toute sécurité.
Distinguer la dégradation des performances d’une défaillance d’intégrité
Commencez par cerner le symptôme exact : recherches lentes, requêtes de chronologie lentes, base de données volumineuse, activité disque élevée, erreurs PostgreSQL récurrentes, boucles de récupération après incident ou migration Immich impossible à terminer. Les symptômes de performance et ceux d’intégrité présentent des risques différents et ne doivent pas donner lieu à la même première réparation.
Vérifiez que l’hôte dispose toujours d’un stockage en bon état, d’un espace libre suffisant, d’une mémoire au comportement normal et qu’aucune tâche Immich en arrière-plan ne tourne en boucle avant d’incriminer PostgreSQL. Un disque saturé ou défaillant peut ralentir une base de données saine et aussi l’endommager réellement si le stockage sous-jacent devient peu fiable.
Avant toute maintenance intrusive, conservez les journaux, la version de la base de données, les versions des extensions, l’historique récent des mises à niveau et une sauvegarde ou un instantané. Si la seule copie de la base de données est peut-être corrompue, ne lancez pas de nettoyage destructif juste pour voir si l’erreur disparaît ; conservez les éléments nécessaires à une décision de restauration maîtrisée.
Repérer les signes de maintenance mesurables
La maintenance de routine devient une piste crédible lorsque la base de données démarre et reste utilisable, mais que les performances des requêtes ou l’espace disque se dégradent avec le temps. Les signes utiles comprennent l’accumulation de lignes mortes, des tables ou des index dont la taille augmente de manière disproportionnée, un autovacuum qui ne suit pas le rythme, des statistiques de planification obsolètes ou des opérations de maintenance de longue durée bloquées par d’autres sessions.
Les tuples morts, le bloat, la pression liée au gel, les opérations VACUUM bloquées et une fréquence de vacuum insuffisante peuvent tous affecter la maintenance et les performances des requêtes PostgreSQL. Utilisez les indicateurs VACUUM au niveau des tables au fil du temps, au lieu de supposer qu’un gros fichier de base de données prouve à lui seul que la base doit être remplacée.
Si les statistiques désignent une table ou un index, choisissez l’action de maintenance prise en charge la moins invasive pour ce problème et mesurez à nouveau. Évitez de passer directement à VACUUM FULL, à des opérations REINDEX étendues ou à un réglage arbitraire d’autovacuum sur l’ensemble du cluster ; ces actions peuvent entraîner des verrous, des E/S ou une consommation supplémentaire d’espace disque, sans forcément résoudre le véritable goulot d’étranglement.
Vérifiez si le bloat ou la croissance des index correspond au chemin d’exécution lent
Comparez les objets concernés par les opérations Immich lentes en tenant compte de la taille des tables et des index, du renouvellement des lignes et du comportement des requêtes. Le bloat est important lorsqu’il augmente le travail nécessaire pour trouver les lignes pertinentes ou réduit l’efficacité des index, mais la base de données peut aussi être volumineuse simplement parce que la bibliothèque et les métadonnées sont importantes.
Le bloat des tables et celui des index doivent être évalués séparément, car un bloat excessif peut augmenter le travail nécessaire aux requêtes sans pour autant indiquer une corruption de la base de données. Utilisez des vérifications mesurées du bloat de PostgreSQL pour cibler un objet observé et actualisez les statistiques du planificateur lorsque cela est pertinent, plutôt que de considérer la taille totale de la base comme un diagnostic.
Après la maintenance, relancez exactement l’opération Immich qui était lente et comparez la latence perçue par l’utilisateur ainsi que le comportement de la base de données et du stockage. Si l’opération ne s’améliore pas, rétablissez si possible les réglages précédents et examinez le stockage, les modèles de requête, les tâches en arrière-plan ou les causes liées à l’application, au lieu d’accumuler d’autres modifications de la base de données.
Passez à une restauration ou à un remplacement en cas de doute sur l’intégrité
Le remplacement est justifié par des preuves indiquant que l’état actuel de PostgreSQL n’est pas fiable ou ne peut pas être récupéré sans risque, et non par son ancienneté seule. Cela peut inclure une corruption de page ou de somme de contrôle reproductible, des échecs persistants au démarrage ou à la récupération malgré un stockage sain, un cluster endommagé après un incident de stockage incomplet, ou un état de migration qui ne peut pas être réparé par la procédure prise en charge.
Avant de déclarer la base de données perdue, vérifiez qu’une sauvegarde fiable peut être restaurée dans un environnement PostgreSQL propre et compatible et qu’Immich peut la lire. Si la restauration propre fonctionne alors que le cluster actuel reproduit la même défaillance d’intégrité, vous avez de bien meilleures raisons de remplacer l’état de la base de données plutôt que de poursuivre les réparations sur place.
Réparez les défaillances localisées et réversibles tout en préservant les données persistantes incertaines ; ne reconstruisez que lorsque la source de récupération est vérifiée et que la cible est reproductible. Appliquez également cette limite entre réparation et reconstruction d’Immich à la base de données. Par « remplacement », on entend restaurer un état PostgreSQL compatible à partir d’une source fiable, et non changer de base de données parce qu’une requête est devenue lente.
Valider la base de données au moyen d’opérations de lecture, d’écriture et de sauvegarde
Que vous ayez effectué une maintenance ou restauré une base de données saine, validez le résultat dans Immich au lieu de vous contenter d’un démarrage réussi de PostgreSQL. Ouvrez d’anciens albums et fichiers, lancez des recherches, lisez quelques vidéos représentatives et vérifiez que les utilisateurs et les paramètres de partage sont conformes aux attentes.
Effectuez une nouvelle écriture sans risque, par exemple en téléversant un fichier temporaire, puis vérifiez qu’il reste accessible après un redémarrage normal du service. Surveillez les journaux de PostgreSQL et d’Immich pour repérer toute réapparition d’erreurs d’intégrité, de migration, d’extension ou d’autorisation pendant que les opérations de lecture et d’écriture sont actives.
Enfin, créez une nouvelle sauvegarde de la base de données avec votre méthode habituelle et, si possible, testez sa restauration sur une cible isolée. La décision de maintenance ou de remplacement n’est définitive que lorsque le système actuel est utilisable et que le prochain point de récupération est manifestement plus sain que l’état à l’origine de l’incident.
Assistance et conseils
À lire aussi

Comment cacher les vidéos pour adultes stockées sur votre NAS à votre famille
Gardez les vidéos pour adultes privées sur un NAS familial. Vérifiez les autorisations des dossiers, l’accès aux bibliothèques Plex et Jellyfin, les vignettes, l’historique...

Ce qu’il faut vérifier avant de charger un modèle communautaire dans Transformers
Utilisez la mise à jour du bac à sable Jinja de Transformers pour examiner la provenance des modèles, les modèles de conversation, le code...

Exécutez Mirage localement : OCR et détection d’objets à partir d’une seule image
Essayez le petit modèle de vision local de Cactus Compute, testez la reconnaissance optique de caractères et l’extraction d’objets à partir de données réelles,...



