// PostgreSQL 오류 참조

PostgreSQL 53100: 디스크가 가득 참

데이터 디렉터리, WAL 또는 임시 파일을 포함하는 파일 시스템이 가득 찼습니다. 공간이 확보될 때까지 쓰기가 실패하며, WAL 디스크가 가득 차면 서버가 중지될 수 있습니다.

SQLSTATE
53100
이름
disk_full
카테고리
리소스 부족
오류 메시지
could not extend file "base/16384/16397": No space left on device
HINT:  Check free disk space.

의미

PostgreSQL이 No space left on device 테이블이나 인덱스 파일을 늘리거나, 임시 정렬 파일을 쓰거나, WAL을 쓰는 동안 운영 체제가 알려 주는 것입니다. 문은 53100 (disk_full) 그리고 해당 트랜잭션은 롤백됩니다.

WAL 디렉터리(pg_wal)가 가득 차면 서버는 변경 사항을 기록할 수 없어 PANIC과 함께 종료되고, 공간이 확보될 때까지 다시 시작되지 않습니다. 다음의 파일은 절대 직접 삭제하지 마세요 pg_wal 수동으로.

일반적인 원인

  • 데이터 증가, 또는 충분한 VACUUM 없이 잦은 업데이트와 삭제로 테이블과 인덱스가 부풀어 오르는 문제.
  • WAL이 쌓이는 이유는 복제 슬롯이 비활성 상태이거나, 아카이빙(archive_command)이 실패하거나, max_wal_size / wal_keep_size 가 크기 때문입니다.
  • 큰 정렬, 해시 또는 CREATE INDEX 임시 파일을 쓰고 있는 경우입니다.
  • 서버 로그나 같은 볼륨에 있는 다른 파일들입니다.

해결 방법

  1. 어떤 것이 공간을 사용하고 있는지 확인하세요.

    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. WAL을 뒤로 미루고 있는 복제 슬롯을 찾아 더 이상 사용하지 않는 것은 제거하세요.

    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. WAL 아카이빙이 성공하는지 확인하세요.

    SELECT archived_count, failed_count, last_failed_wal, last_failed_time FROM pg_stat_archiver;
  4. 디스크 공간을 확보하거나 추가합니다: 볼륨을 늘리거나, 관련 없는 파일을 삭제하거나, 다음으로 부풀어 오른 공간을 정리합니다: VACUUM FULL (테이블 전체 복사본만큼의 공간이 필요함) 또는 pg_repack.

  5. 세션당 임시 파일 사용을 제한하여 하나의 쿼리가 디스크를 가득 채우지 않도록 합니다.

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

관련 오류

그 밖의 리소스 부족 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 PostgreSQL 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.