Sinais de que uma base de dados do Immich precisa de manutenção ou substituição

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

Uma base de dados do Immich simplesmente lenta pode precisar de manutenção de rotina do PostgreSQL ou de uma correção de recursos; uma base de dados que apresente falhas repetidas de integridade ou recuperação pode precisar de ser restaurada ou substituída a partir de uma cópia de segurança verificada.

Não use «reconstruir a base de dados» como solução genérica para problemas de desempenho. Primeiro, distinga o crescimento normal, a fragmentação, as estatísticas desatualizadas, as operações de manutenção bloqueadas e a latência do armazenamento da corrupção ou de um estado do cluster irrecuperável. Preserve um ponto de recuperação antes de qualquer intervenção invasiva, avalie cada alteração de manutenção individualmente e só opte por uma restauração limpa quando as provas indicarem que não é possível confiar na base de dados atual nem repará-la em segurança.

Distinga a degradação do desempenho das falhas de integridade

Comece pelo sintoma exato: pesquisas lentas, consultas à cronologia lentas, base de dados de grandes dimensões, atividade intensa no disco, erros repetidos do PostgreSQL, ciclos de recuperação após falhas ou uma migração do Immich que não consegue terminar. Os problemas de desempenho e os problemas de integridade envolvem riscos diferentes e não devem ter a mesma primeira medida de reparação.

Confirme que o anfitrião continua a dispor de armazenamento em boas condições, espaço livre suficiente, utilização normal da memória e que não há nenhuma tarefa em segundo plano do Immich a consumir recursos excessivos antes de atribuir o problema ao PostgreSQL. Um disco sobrecarregado ou avariado pode fazer uma base de dados saudável parecer lenta e também causar danos reais na base de dados se o armazenamento subjacente se tornar instável.

Antes de realizar operações de manutenção invasivas, guarde os registos, a versão da base de dados, as versões das extensões, o histórico de atualizações recentes e uma cópia de segurança ou instantâneo. Se a única cópia da base de dados puder estar corrompida, não execute uma limpeza destrutiva só para ver se o erro desaparece; conserve as provas necessárias para decidir de forma controlada se deve restaurá-la.

Procure sinais de manutenção que possa medir

A manutenção de rotina torna-se uma opção plausível quando a base de dados arranca e continua funcional internamente, mas o desempenho das consultas ou o espaço ocupado em disco piora com o tempo. Os indícios úteis incluem a acumulação de linhas obsoletas, tabelas ou índices que crescem de forma desproporcionada, o autovacuum que não consegue acompanhar, estatísticas desatualizadas do planeador ou operações de manutenção prolongadas bloqueadas por outras sessões.

Tuplos mortos, fragmentação, pressão de congelamento, VACUUM bloqueado e frequência de vacuum insuficiente podem afetar a manutenção e o desempenho das consultas do PostgreSQL. Utilize indicadores de VACUUM ao nível da tabela ao longo do tempo, em vez de presumir que um ficheiro de base de dados grande, por si só, prova que a base de dados precisa de ser substituída.

Se as estatísticas apontarem para uma tabela ou um índice, escolha a ação de manutenção suportada menos invasiva para essa situação e volte a medir. Evite avançar diretamente para VACUUM FULL, operações REINDEX abrangentes ou ajustes arbitrários do autovacuum em todo o cluster; essas ações podem causar bloqueios, atividade de E/S ou maior necessidade de espaço em disco, sem resolver o verdadeiro estrangulamento.

Confirme se a fragmentação ou o crescimento do índice correspondem ao percurso lento

Compare os objetos envolvidos nas operações lentas do Immich com o tamanho das tabelas e dos índices, a rotatividade das linhas e o comportamento das consultas. A fragmentação é relevante quando aumenta o trabalho necessário para encontrar linhas úteis ou reduz a eficácia dos índices, mas a base de dados também pode ser grande simplesmente porque a biblioteca e os metadados são extensos.

A fragmentação das tabelas e dos índices deve ser avaliada separadamente, pois uma fragmentação excessiva pode aumentar o trabalho necessário para executar consultas sem implicar corrupção da base de dados. Utilize verificações da fragmentação do PostgreSQL baseadas em medições para analisar um objeto observado e atualizar as estatísticas do planeador, quando apropriado, em vez de tratar o tamanho total da base de dados como diagnóstico.

Após a manutenção, volte a executar exatamente a mesma ação do Immich que estava lenta e compare tanto a latência visível para o utilizador como o comportamento da base de dados e do armazenamento. Se a operação não melhorar, reverta, sempre que possível, as afinações anteriores e investigue o armazenamento, os padrões de consulta, as tarefas em segundo plano ou as causas ao nível da aplicação, em vez de acumular mais alterações à base de dados.

Escalone para restauro ou substituição quando a integridade for incerta

A substituição justifica-se quando há provas de que o estado atual do PostgreSQL não é fiável ou não pode ser recuperado em segurança, não apenas pela sua idade. Entre os exemplos contam-se corrupção repetível de páginas ou somas de verificação, falhas de arranque ou recuperação que persistem mesmo com armazenamento em bom estado, um cluster danificado após um incidente de armazenamento incompleto ou um estado de migração que não pode ser reparado através do procedimento suportado.

Antes de declarar a base de dados perdida, comprove que é possível restaurar uma cópia de segurança comprovadamente fiável num ambiente PostgreSQL limpo e compatível e que o Immich consegue lê-la. Se o restauro limpo funcionar, enquanto o cluster atual volta a apresentar a mesma falha de integridade, terá razões muito mais sólidas para substituir o estado da base de dados, em vez de continuar a repará-lo no local.

Repare falhas localizadas e reversíveis, preservando os dados persistentes cujo estado seja incerto; reconstrua apenas quando a origem de recuperação estiver verificada e o destino puder ser reproduzido. Aplique também esse critério entre reparar e reconstruir o Immich à base de dados. «Substituição» deve significar restaurar um estado compatível do PostgreSQL a partir de uma origem comprovadamente fiável, e não mudar de base de dados porque uma consulta ficou mais lenta.

Validar a base de dados através de operações de leitura, escrita e cópia de segurança

Quer tenha feito uma manutenção ou restaurado uma base de dados limpa, valide o resultado através do Immich, em vez de se limitar a confirmar que o PostgreSQL iniciou com sucesso. Abra álbuns e recursos antigos, faça pesquisas, carregue vídeos representativos e verifique se os utilizadores e as definições de partilha aparecem como esperado.

Faça uma nova gravação segura, como carregar um recurso descartável, e confirme que continua acessível após um reinício normal do serviço. Acompanhe os registos do PostgreSQL e do Immich para detetar erros recorrentes de integridade, migração, extensões ou permissões, enquanto os percursos de leitura e escrita estiverem ativos.

Por fim, crie uma nova cópia de segurança da base de dados usando o método habitual e, quando for viável, teste o restauro num destino isolado. A decisão de manutenção ou substituição só está concluída quando o sistema atual estiver utilizável e o próximo ponto de recuperação for comprovadamente mais saudável do que o estado que desencadeou o incidente.

Assistência e dicas

Mais para ler

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.