SQLITE_CORRUPT: 데이터베이스 디스크 이미지가 손상되었습니다
SQLite가 데이터베이스 파일 구조의 손상을 감지했습니다. 파일에 쓰기를 멈추고 복사본을 만든 다음, .recover 명령이나 백업으로 복구할 수 있는 만큼 살려내세요.
- 결과 코드
SQLITE_CORRUPT- 이름
11- 카테고리
- 주요 결과 코드
의미
SQLITE_CORRUPT (11)은 SQLite가 파일에서 형식에 맞지 않는 것을 읽었다는 뜻입니다: 깨진 페이지, 잘못된 포인터, 일치하는 행이 없는 인덱스 항목. 정상적인 사용에서 SQLite가 스스로 파일을 손상시키는 일은 없습니다. SQLite 문서("How To Corrupt An SQLite Database File")는 손상되는 경우를 나열합니다: 트랜잭션이 열려 있는 동안 파일을 복사하는 경우, 깨진 파일 잠금(주로 네트워크 파일 시스템), 핫 저널 삭제, 하드웨어나 저장 장치 고장, 그리고 다른 코드가 파일에 기록하는 경우.
SQLITE_CORRUPT_INDEX 이는 인덱스만 손상된 특수한 경우이며 REINDEX 이 문제가 해결될 수 있습니다.
일반적인 원인
- id 범위가 겹치는 상태에서 데이터베이스 간에 행을 복사하는 경우.
-wal파일. - 삭제할 때
-journal또는-wal크래시 후 남은 파일. - 잠금이 믿을 만하지 못한 네트워크 파일 시스템이나 컨테이너 볼륨이라 쓰기 둘이 동시에 들어옵니다.
- 디스크, 메모리 또는 전원 오류, 또는 fsync를 무시하는 스토리지 계층.
- 프로그램의 다른 부분이 열린 파일 디스크립터를 통해 파일에 직접 쓰기.
해결 방법
-
데이터베이스에 쓰기를 멈추고 파일과 그 밖의
-wal그리고-journal파일은 아무것도 시도하기 전에 백업해 두세요 -
손상 정도 측정.
PRAGMA integrity_check;
-
인덱스만 영향을 받았다면 재구축하세요.
REINDEX;
-
그 외에는 다음으로 데이터를 새 파일로 복구합니다
sqlite3셸의.recover명령을 실행한 다음 결과를 확인하세요:sqlite3 broken.db .recover | sqlite3 recovered.db. -
복구가 완료되지 않았다면 백업에서 복원하고, 앞으로의 백업은 다음으로 만드세요
VACUUM INTO또는 파일이 쓰이는 동안 복사하는 대신 백업 API를 쓰세요.VACUUM INTO '/backups/app-2026-11-09.db';
관련 오류
SQLITE_NOTADB파일이 데이터베이스가 아님SQLITE_IOERR디스크 I/O 오류SQLITE_BUSY데이터베이스가 잠김824SQL Server: 논리적 일관성 기반 I/O 오류
그 밖의 기본 결과 코드 오류
SQLITE_ERRORSQL 논리 오류SQLITE_PERM접근 권한 거부SQLITE_ABORT쿼리 중단됨SQLITE_LOCKED데이터베이스 테이블이 잠김SQLITE_NOMEM메모리 부족SQLITE_READONLY읽기 전용 데이터베이스에 쓰기 시도SQLITE_INTERRUPT중단됨SQLITE_FULL데이터베이스 또는 디스크가 가득 참
코드와 메시지 텍스트의 출처는 다음과 같습니다 SQLite 결과 및 오류 코드 문서. 전체 목록은 SQLite 오류 목록 또는 모든 데이터베이스 오류 검색.
SQLly에서 SQLite 작업하기
스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. SQLite는 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.