// Referencia de errores de PostgreSQL

PostgreSQL 53100: disco lleno

El sistema de archivos que aloja el directorio de datos, el WAL o los archivos temporales está lleno. Las escrituras fallan hasta que liberes espacio; un disco WAL lleno puede detener el servidor.

SQLSTATE
53100
Nombre
disk_full
Categoría
Recursos insuficientes
Mensaje de error
could not extend file "base/16384/16397": No space left on device
HINT:  Check free disk space.

Qué significa

PostgreSQL recibió No space left on device del sistema operativo al agrandar un archivo de tabla o de índice, escribir archivos de ordenación temporales o escribir el WAL. La instrucción falla con 53100 (disk_full) y su transacción se revierte.

Si el directorio WAL (pg_wal) se llena, el servidor no puede escribir ningún cambio y se apaga con un PANIC; no volverá a arrancar hasta que liberes espacio. Nunca borres archivos de pg_wal A mano.

Causas comunes

  • Crecimiento de datos, o tablas e índices hinchados por actualizaciones y borrados masivos sin suficiente vacuum.
  • Acumulación de WAL porque un slot de replicación está inactivo, el archivado (archive_command) está fallando, o max_wal_size / wal_keep_size son grandes.
  • Una ordenación grande, un hash o CREATE INDEX escribiendo archivos temporales.
  • Registros del servidor u otros archivos en el mismo volumen.

Cómo solucionarlo

  1. Encuentra qué está usando el espacio.

    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. Busca slots de replicación que retengan WAL, y elimina los que ya no se usan.

    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. Comprueba que el archivado de WAL funcione.

    SELECT archived_count, failed_count, last_failed_wal, last_failed_time FROM pg_stat_archiver;
  4. Libera o añade espacio en disco: amplía el volumen, elimina archivos ajenos o recupera el espacio desperdiciado con VACUUM FULL (que necesita espacio para una copia completa de la tabla) o pg_repack.

  5. Limita el uso de archivos temporales por sesión para que una consulta no pueda llenar el disco.

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

Errores relacionados

Más errores de recursos insuficientes

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.