// SQLite 오류 참조

SQLITE_FULL: 데이터베이스 또는 디스크가 가득 찼습니다

디스크나 임시 파일용 파티션의 공간이 부족해졌거나, 데이터베이스가 max_page_count 한도에 도달해 쓰기가 실패했습니다.

결과 코드
SQLITE_FULL
이름
13
카테고리
주요 결과 코드
오류 메시지
database or disk is full

의미

SQLITE_FULL (13)은 공간이 부족해 SQLite가 쓰기를 마치지 못했다는 뜻입니다. SQLite 문서가 짚는 흔한 함정: 공간은 데이터베이스가 있는 곳이 아니라 임시 디렉터리에서 부족해질 수 있습니다. 큰 정렬, 인덱스 생성, 그리고 VACUUM 임시 파일을 쓰는데, temp 파티션은 훨씬 작을 수 있습니다.

데이터베이스가 설정된 페이지 한도에 도달하면 동일한 코드가 반환됩니다 PRAGMA max_page_count.

일반적인 원인

  • 데이터베이스, 그 저널 또는 WAL 파일이 들어 있는 디스크가 가득 찼습니다.
  • 임시 디렉터리는 작은 파티션에 있습니다(예: 작은 /tmp), 그리고 큰 ORDER BY, CREATE INDEX 또는 VACUUM 채웠습니다.
  • PRAGMA max_page_count 데이터베이스 크기를 제한합니다.
  • 체크포인트를 완료할 수 없어 매우 커진 WAL 파일입니다.

해결 방법

  1. 볼륨의 여유 공간을 확보하거나, 데이터베이스를 더 큰 볼륨으로 이동하세요.

  2. 임시 파일을 더 큰 디렉터리로 보내는 옵션은 SQLITE_TMPDIR 또는 TMPDIR 환경 변수를 설정하거나, 데이터 크기가 허락된다면 메모리에 둡니다.

    PRAGMA temp_store = MEMORY;
  3. 설정된 경우, 페이지 제한을 확인하고 늘리세요.

    PRAGMA max_page_count;
    PRAGMA max_page_count = 2147483646;
  4. WAL 모드에서는 읽기 작업이 모두 끝난 뒤 체크포인트를 실행해 WAL을 줄이세요.

    PRAGMA wal_checkpoint(TRUNCATE);

관련 오류

그 밖의 기본 결과 코드 오류

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

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

SQLly에서 SQLite 작업하기

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