// Referência de erro do PostgreSQL

PostgreSQL XX001: dados corrompidos

PostgreSQL leu uma página de dados que falhou nas verificações de sanidade ou checksum. Trate isso como corrupção de armazenamento: proteja os dados, depois restaure ou recupere.

SQLSTATE
XX001
Nome
data_corrupted
Categoria
Erro interno
Mensagem de erro
invalid page in block 1234 of relation base/16384/16397

O que significa

XX001 (data_corrupted) significa que uma página lida do disco não é válida: o cabeçalho é lixo, o checksum não confere (quando os checksums de dados estão habilitados) ou um arquivo é menor do que a tabela precisa (could not read block ... read only 0 of 8192 bytes). O caminho do arquivo na mensagem (base/<database oid>/<relfilenode>) identifica a tabela ou índice.

O próprio PostgreSQL raramente causa isso. As fontes habituais são discos ou controladores com falha, armazenamento que mente sobre a gravação, uma falha de hardware sem a ordenação correta de gravação, ou arquivos copiados ou restaurados de forma inconsistente.

Causas comuns

  • Falhas de hardware ou de armazenamento: discos, controladoras RAID, volumes SAN ou de nuvem.
  • Cache de gravação que não respeita fsynct), seguido por perda de energia ou falha.
  • fsync = off ou full_page_writes = off em produção.
  • Um backup feito copiando o diretório de dados sem pg_basebackup ou a API de backup, ou arquivos alterados por outro software.

Como corrigir

  1. Pare e faça uma cópia em nível de arquivo de todo o diretório de dados antes de tentar qualquer reparo, para que nada do que você fizer possa piorar a situação.

  2. Descubra a qual objeto o arquivo pertence.

    SELECT relname, relkind FROM pg_class WHERE relfilenode = 16397;
  3. Se for um índice, reconstrua-o.

    REINDEX INDEX CONCURRENTLY orders_pkey;
  4. Se for uma tabela, restaure-a a partir de um backup ou de uma réplica. Como último recurso para recuperar as linhas legíveis, zero_damaged_pages = on faz com que o PostgreSQL ignore páginas ruins (perdendo suas linhas) enquanto você copia a tabela.

    SET zero_damaged_pages = on;  -- superuser, salvage only
    CREATE TABLE orders_salvage AS SELECT * FROM orders;
    RESET zero_damaged_pages;
  5. Verifique os logs de hardware e de armazenamento, e habilite checksums de dados em novos clusters (initdb --data-checksums, ou pg_checksums --enable em um cluster parado) para que a corrupção seja detectada logo.

Erros relacionados

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.