Un database Immich semplicemente lento potrebbe aver bisogno della normale manutenzione di PostgreSQL o di una correzione delle risorse; un database che presenta ripetuti problemi di integrità o di ripristino potrebbe dover essere ripristinato da un backup verificato o sostituito con uno.
Non usare «ricostruire il database» come soluzione generica ai problemi di prestazioni. Distingui innanzitutto la normale crescita, la frammentazione, le statistiche non aggiornate, la manutenzione bloccata e la latenza dell’archiviazione dalla corruzione o da uno stato del cluster irrecuperabile. Crea un punto di ripristino prima di intervenire in modo invasivo, misura una modifica di manutenzione alla volta e passa a un ripristino pulito solo quando le prove indicano che non ci si può fidare del database attuale o che non è possibile ripararlo in sicurezza.
Distingui il calo delle prestazioni dai problemi di integrità
Inizia dal sintomo preciso: ricerche lente, query della timeline lente, database di grandi dimensioni, intensa attività del disco, errori PostgreSQL ripetuti, cicli di ripristino dopo un arresto anomalo oppure una migrazione di Immich che non riesce a completarsi. I problemi di prestazioni e quelli di integrità comportano rischi diversi e non dovrebbero essere affrontati con lo stesso primo intervento di riparazione.
Prima di dare la colpa a PostgreSQL, verifica che il sistema host disponga ancora di spazio di archiviazione in buono stato, spazio libero sufficiente e un uso normale della memoria, e che non ci siano processi in background di Immich fuori controllo. Un disco saturo o in avaria può far sembrare lento un database integro e può anche causare danni reali al database se l’archiviazione sottostante diventa inaffidabile.
Prima di interventi invasivi, conserva i log, la versione del database, le versioni delle estensioni, la cronologia degli aggiornamenti recenti e un backup o uno snapshot. Se l’unica copia del database potrebbe essere danneggiata, non eseguire operazioni di pulizia distruttive solo per vedere se l’errore scompare; conserva le prove necessarie per decidere in modo controllato se ripristinarlo.
Cerca segnali di manutenzione misurabili
La manutenzione ordinaria può essere una soluzione plausibile quando il database si avvia e rimane utilizzabile internamente, ma le prestazioni delle query o l’occupazione del disco peggiorano con il tempo. Tra gli indizi utili ci sono l’accumulo di righe morte, tabelle o indici che crescono in modo sproporzionato, autovacuum che non riesce a tenere il passo, statistiche del pianificatore non aggiornate o operazioni di manutenzione di lunga durata bloccate da altre sessioni.
Le tuple morte, la bloat, la pressione dovuta al congelamento, le operazioni VACUUM bloccate e una frequenza di vacuum insufficiente possono influire sulla manutenzione e sulle prestazioni delle query di PostgreSQL. Nel tempo, usa indicatori VACUUM a livello di tabella invece di presumere che un file di database di grandi dimensioni dimostri da solo che il database debba essere sostituito.
Se le statistiche indicano una tabella o un indice, scegli l’intervento di manutenzione supportato meno invasivo per il problema rilevato e misura di nuovo. Evita di passare subito a VACUUM FULL, a operazioni REINDEX estese o a modifiche arbitrarie di autovacuum sull’intero cluster: queste azioni possono causare blocchi, I/O o ulteriore richiesta di spazio su disco e potrebbero non risolvere il vero collo di bottiglia.
Verifica se la bloat o la crescita degli indici corrispondono al percorso lento
Confronta gli oggetti coinvolti nelle operazioni lente di Immich con le dimensioni di tabelle e indici, la variazione delle righe e il comportamento delle query. La bloat è rilevante quando aumenta il lavoro necessario per trovare le righe utili o rende meno efficaci gli indici, ma il database può anche essere grande semplicemente perché la libreria e i metadati sono voluminosi.
La bloat di tabelle e indici va valutata separatamente, perché una bloat eccessiva può aumentare il lavoro richiesto dalle query senza implicare una corruzione del database. Usa controlli della bloat di PostgreSQL basati su misurazioni per concentrarti su un oggetto effettivamente interessato e aggiorna le statistiche del pianificatore, se opportuno, invece di considerare la dimensione totale del database come una diagnosi.
Dopo la manutenzione, ripeti esattamente l’operazione di Immich che era lenta e confronta sia la latenza percepita dall’utente sia il comportamento del database e dello storage. Se l’operazione non migliora, ripristina, ove possibile, la configurazione precedente e verifica lo storage, i modelli delle query, i processi in background o le cause a livello applicativo, invece di accumulare altre modifiche al database.
Passa al ripristino o alla sostituzione quando l’integrità è incerta
La sostituzione è giustificata da prove che lo stato attuale di PostgreSQL non sia affidabile o recuperabile in sicurezza, non dalla sua sola età. Tra gli esempi rientrano il danneggiamento ripetibile di pagine o checksum, problemi di avvio o ripristino che persistono su uno storage integro, un cluster danneggiato dopo un problema di storage incompleto o uno stato di migrazione che non può essere riparato seguendo la procedura supportata.
Prima di dichiarare perso il database, verifica che un backup affidabile possa essere ripristinato in un ambiente PostgreSQL pulito e compatibile e che Immich riesca a leggerlo. Se il ripristino pulito funziona mentre il cluster attuale continua a presentare lo stesso problema di integrità, hai elementi molto più solidi per sostituire lo stato del database invece di continuare a ripararlo sul posto.
Ripara i guasti circoscritti e reversibili, preservando i dati persistenti di cui non conosci con certezza l'integrità; ricostruisci solo quando la fonte di ripristino è verificata e la destinazione è riproducibile. Applica questo criterio di Immich per decidere se riparare o ricostruire anche al database. Per «sostituzione» si intende ripristinare uno stato PostgreSQL compatibile da una fonte affidabile, non cambiare database perché una query è diventata lenta.
Verifica il database con operazioni di lettura, scrittura e backup
Che tu abbia eseguito la manutenzione o ripristinato un database integro, verifica il risultato tramite Immich invece di fermarti al corretto avvio di PostgreSQL. Apri vecchi album e file multimediali, esegui ricerche, carica video rappresentativi e verifica che utenti e impostazioni di condivisione siano quelli previsti.
Esegui una nuova scrittura sicura, ad esempio caricando un file multimediale sacrificabile, e verifica che resti accessibile dopo un normale riavvio del servizio. Controlla i log di PostgreSQL e Immich per individuare eventuali errori ricorrenti di integrità, migrazione, estensioni o autorizzazioni mentre i percorsi di lettura e scrittura sono attivi.
Infine, crea un nuovo backup del database con il metodo abituale e, quando possibile, verifica il ripristino su un sistema isolato. La decisione di eseguire la manutenzione o la sostituzione è completa solo quando il sistema attuale è utilizzabile e il successivo punto di ripristino è dimostrabilmente più integro rispetto allo stato che ha causato l'incidente.
Assistenza e consigli
Altre letture

Come tenere nascosti i video per adulti sul tuo NAS ai tuoi familiari
Tieni privati i video per adulti su un NAS familiare. Controlla le autorizzazioni delle cartelle, l’accesso alle librerie di Plex e Jellyfin, le miniature,...

Cosa controllare prima di caricare un modello della community in Transformers
Usa l’aggiornamento della sandbox Jinja di Transformers per esaminare la provenienza dei modelli, i template di chat, il codice remoto, i pesi serializzati e...

Esegui Mirage in locale: OCR e rilevamento degli oggetti da una sola immagine
Prova il piccolo modello di visione locale di Cactus Compute, verifica l’OCR e l’estrazione degli oggetti con input reali e comprendi i limiti di...



