// Referência de erro do PostgreSQL

PostgreSQL 53100: disco cheio

O sistema de arquivos que contém o diretório de dados, WAL ou arquivos temporários está cheio. As gravações falham até que espaço seja liberado; um disco de WAL cheio pode parar o servidor.

SQLSTATE
53100
Nome
disk_full
Categoria
Recursos insuficientes
Mensagem de erro
could not extend file "base/16384/16397": No space left on device
HINT:  Check free disk space.

O que significa

PostgreSQL recebeu No space left on device do sistema operacional enquanto aumentava o tamanho de um arquivo de tabela ou índice, escrevia arquivos temporários de ordenação ou escrevia WAL. A instrução falha com 53100 (disk_full) e sua transação é revertida.

Se o diretório WAL (pg_wal) se encher, o servidor não consegue gravar nenhuma alteração e fecha com um PANIC; ele não iniciará novamente até que o espaço seja liberado. Nunca exclua arquivos de pg_wal à mão.

Causas comuns

  • Crescimento de dados, ou inchaço de tabela e índice devido a atualizações e exclusões pesadas sem limpeza (vacuum) suficiente.
  • WAL se acumulando porque um slot de replicação está inativo, arquivamento (archive_command) está falhando, ou max_wal_size / wal_keep_size são grandes.
  • Uma grande ordenação, hash ou CREATE INDEX escrevendo arquivos temporários.
  • Logs do servidor ou outros arquivos no mesmo volume.

Como corrigir

  1. Descubra o que é dono do nome.

    SELECT pg_size_pretty(pg_database_size(current_database()));
    SELECT relname, pg_size_pretty(pg_total_relation_size(oid)) AS size
    FROM pg_class WHERE relkind = 'r'
    ORDER BY pg_total_relation_size(oid) DESC LIMIT 10;
  2. Procure slots de replicação que estão retendo WAL e remova aqueles que não são mais usados.

    SELECT slot_name, active, pg_size_pretty(pg_wal_lsn_diff(pg_current_wal_lsn(), restart_lsn)) AS retained
    FROM pg_replication_slots;
    SELECT pg_drop_replication_slot('old_slot');
  3. Verifique se o arquivamento de WAL está ocorrendo com sucesso.

    SELECT archived_count, failed_count, last_failed_wal, last_failed_time FROM pg_stat_archiver;
  4. Libere ou adicione espaço em disco: aumente o volume, remova arquivos sem relação ou elimine o inchaço com VACUUM FULL (que precisa de espaço para uma cópia completa da tabela) ou pg_repack.

  5. Limite o uso de arquivos temporários por sessão para que uma consulta não preencha o disco.

    ALTER SYSTEM SET temp_file_limit = '20GB';
    SELECT pg_reload_conf();

Erros relacionados

Mais erros de recursos insuficientes

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.