// 오류 참조

SQLite 오류 코드

공식 목록의 모든 SQLite 결과 코드, 기본 코드와 확장 코드, 그 텍스트까지 sqlite3_errstr() 각 기본 코드에 어떤 값을 돌려주는지 보여 줍니다. 자주 마주치게 될 코드들은 원인과 해결 방법을 다룬 전체 페이지가 있습니다.

SQLite 오류 읽기

SQLite 함수는 정수 결과 코드를 반환합니다. 하위 8비트가 기본 코드인데, 예를 들면 SQLITE_BUSY (5). 확장 코드는 상위 비트에 세부 정보를 담습니다: SQLITE_BUSY_SNAPSHOT 517이고, 이는 5 + 2 × 256입니다. 확장 코드는 다음으로 활성화했을 때 반환됩니다 sqlite3_extended_result_codes() 또는 다음으로 읽습니다 sqlite3_extended_errcode().

프로그램이 표시하는 메시지는 보통 다음에서 나옵니다 sqlite3_errmsg(), 일반 텍스트보다 구체적일 수 있는데, 예를 들면 UNIQUE constraint failed: users.email 다음 대신 constraint failed.

언어 바인딩은 이러한 코드를 래핑합니다: Python의 sqlite3 모듈은 예외를 발생시킵니다. OperationalError 또는 IntegrityError 그리고 Python 3.11부터는 다음을 노출합니다 sqlite_errorcode 그리고 sqlite_errorname 예외에 대한 자세한 내용이 표시됩니다.

이 참조의 모든 SQLite 오류

105개 코드, 40개는 전체 설명 포함(링크). 코드와 메시지는 SQLite 결과 및 오류 코드 문서.

주요 결과 코드

코드의미
SQLITE_OK 0 오류 아님
SQLITE_ERROR SQL 논리 오류 1 SQL 논리 오류
SQLITE_INTERNAL 2
SQLITE_PERM 접근 권한 거부 3 접근 권한 거부
SQLITE_ABORT 쿼리 중단됨 4 쿼리 중단됨
SQLITE_BUSY 데이터베이스가 잠김 5 데이터베이스가 잠김
SQLITE_LOCKED 데이터베이스 테이블이 잠김 6 데이터베이스 테이블이 잠김
SQLITE_NOMEM 메모리 부족 7 메모리 부족
SQLITE_READONLY 읽기 전용 데이터베이스에 쓰기 시도 8 읽기 전용 데이터베이스에 쓰기 시도
SQLITE_INTERRUPT 중단됨 9 중단됨
SQLITE_IOERR 디스크 I/O 오류 10 디스크 I/O 오류
SQLITE_CORRUPT 데이터베이스 디스크 이미지가 손상됨 11 데이터베이스 디스크 이미지가 손상됨
SQLITE_NOTFOUND 12 알 수 없는 작업
SQLITE_FULL 데이터베이스 또는 디스크가 가득 참 13 데이터베이스 또는 디스크가 가득 참
SQLITE_CANTOPEN 데이터베이스 파일을 열 수 없음 14 데이터베이스 파일을 열 수 없음
SQLITE_PROTOCOL 잠금 프로토콜 15 잠금 프로토콜
SQLITE_EMPTY 16
SQLITE_SCHEMA 데이터베이스 스키마가 변경됨 17 데이터베이스 스키마가 변경됨
SQLITE_TOOBIG 문자열 또는 블롭이 너무 큼 18 문자열 또는 블롭이 너무 큼
SQLITE_CONSTRAINT 제약 조건 실패 19 제약 조건 실패
SQLITE_MISMATCH 데이터 타입 불일치 20 데이터 타입 불일치
SQLITE_MISUSE 잘못된 매개변수 또는 기타 API 오용 21 잘못된 매개변수 또는 기타 API 오용
SQLITE_NOLFS 22
SQLITE_AUTH 권한 거부 23 권한 거부
SQLITE_FORMAT 24
SQLITE_RANGE 열 인덱스 범위를 벗어남 25 열 인덱스 범위를 벗어남
SQLITE_NOTADB 파일이 데이터베이스가 아님 26 파일이 데이터베이스가 아님
SQLITE_NOTICE 27 알림 메시지
SQLITE_WARNING 28 경고 메시지
SQLITE_ROW 100 다른 행이 있음
SQLITE_DONE 101 더 이상 사용 가능한 행이 없습니다

확장 결과 코드

코드의미
SQLITE_OK_LOAD_PERMANENTLY 256
SQLITE_ERROR_MISSING_COLLSEQ 해당 컬레이션 시퀀스가 없습니다 257 해당 컬레이션 시퀀스가 없습니다: unicode_ci
SQLITE_BUSY_RECOVERY 다른 프로세스가 WAL을 복구 중입니다 261 데이터베이스가 잠김
SQLITE_LOCKED_SHAREDCACHE 공유 캐시에서 레코드가 잠겨 있습니다 262 데이터베이스 테이블이 잠김
SQLITE_READONLY_RECOVERY 264
SQLITE_IOERR_READ 266
SQLITE_CORRUPT_VTAB 267
SQLITE_CANTOPEN_NOTEMPDIR 270
SQLITE_CONSTRAINT_CHECK CHECK 제약 조건 실패 275 CHECK 제약 조건 실패: price_positive
SQLITE_AUTH_USER 279
SQLITE_NOTICE_RECOVER_WAL 283
SQLITE_WARNING_AUTOINDEX 284
SQLITE_ERROR_RETRY 513
SQLITE_ABORT_ROLLBACK ROLLBACK으로 인해 명령문이 중단되었습니다 516 ROLLBACK으로 인해 중단됨
SQLITE_BUSY_SNAPSHOT 오래된 읽기는 쓰기로 변환될 수 없습니다 517 데이터베이스가 잠김
SQLITE_LOCKED_VTAB 518
SQLITE_READONLY_CANTLOCK 520
SQLITE_IOERR_SHORT_READ 읽기가 더 적은 바이트를 반환했습니다 522 디스크 I/O 오류
SQLITE_CORRUPT_SEQUENCE 523
SQLITE_CANTOPEN_ISDIR 경로가 디렉토리입니다 526 데이터베이스 파일을 열 수 없음
SQLITE_CONSTRAINT_COMMITHOOK 531
SQLITE_NOTICE_RECOVER_ROLLBACK 539
SQLITE_ERROR_SNAPSHOT 769
SQLITE_BUSY_TIMEOUT 블로킹 파일 잠금 시간 초과 773 데이터베이스가 잠김
SQLITE_READONLY_ROLLBACK 핫 저널은 롤백할 수 없습니다 776 읽기 전용 데이터베이스에 쓰기 시도
SQLITE_IOERR_WRITE 778
SQLITE_CORRUPT_INDEX 인덱스 항목이 없습니다 779 데이터베이스 디스크 이미지가 손상됨
SQLITE_CANTOPEN_FULLPATH 782
SQLITE_CONSTRAINT_FOREIGNKEY 외래 키 제약 조건 실패 787 외래 키 제약 조건 실패
SQLITE_READONLY_DBMOVED 데이터베이스 파일이 열려 있는 동안 이동됨 1032 읽기 전용 데이터베이스에 쓰기 시도
SQLITE_IOERR_FSYNC 1034
SQLITE_CANTOPEN_CONVPATH 1038
SQLITE_CONSTRAINT_FUNCTION 1043
SQLITE_READONLY_CANTINIT 1288
SQLITE_IOERR_DIR_FSYNC 1290
SQLITE_CANTOPEN_DIRTYWAL 1294
SQLITE_CONSTRAINT_NOTNULL NOT NULL 제약 조건 실패 1299 NOT NULL 제약 조건 실패: users.name
SQLITE_READONLY_DIRECTORY 저널 파일을 생성할 수 없음 1544 읽기 전용 데이터베이스에 쓰기 시도
SQLITE_IOERR_TRUNCATE 1546
SQLITE_CONSTRAINT_PRIMARYKEY PRIMARY KEY 제약 조건 실패 1555 UNIQUE 제약 조건 실패: orders.id
SQLITE_IOERR_FSTAT 1802
SQLITE_CONSTRAINT_TRIGGER 트리거에서 RAISE()로 중단됨 1811 제약 조건 실패
SQLITE_IOERR_UNLOCK 2058
SQLITE_CONSTRAINT_UNIQUE UNIQUE 제약 조건 실패 2067 UNIQUE 제약 조건 실패: users.email
SQLITE_IOERR_RDLOCK 2314
SQLITE_CONSTRAINT_VTAB 2323
SQLITE_IOERR_DELETE 2570
SQLITE_CONSTRAINT_ROWID 2579
SQLITE_IOERR_BLOCKED 2826
SQLITE_CONSTRAINT_PINNED 2835
SQLITE_IOERR_NOMEM 3082
SQLITE_CONSTRAINT_DATATYPE 값이 STRICT 열에 맞지 않음 3091 TEXT 값을 INTEGER 컬럼 t.qty에 저장할 수 없음
SQLITE_IOERR_ACCESS 3338
SQLITE_IOERR_CHECKRESERVEDLOCK 3594
SQLITE_IOERR_LOCK 3850
SQLITE_IOERR_CLOSE 4106
SQLITE_IOERR_DIR_CLOSE 4362
SQLITE_IOERR_SHMOPEN 4618
SQLITE_IOERR_SHMSIZE 4874
SQLITE_IOERR_SHMLOCK 5130
SQLITE_IOERR_SHMMAP 5386
SQLITE_IOERR_SEEK 5642
SQLITE_IOERR_DELETE_NOENT 5898
SQLITE_IOERR_MMAP 6154
SQLITE_IOERR_GETTEMPPATH 6410
SQLITE_IOERR_CONVPATH 6666
SQLITE_IOERR_VNODE 6922
SQLITE_IOERR_AUTH 7178
SQLITE_IOERR_BEGIN_ATOMIC 7434
SQLITE_IOERR_COMMIT_ATOMIC 7690
SQLITE_IOERR_ROLLBACK_ATOMIC 7946
SQLITE_IOERR_DATA 8202
SQLITE_IOERR_CORRUPTFS 8458
// 하나의 클라이언트, 모든 엔진

SQLite와 더 빠르게 작업하는 방법

SQLly는 macOS, Windows, Linux용 네이티브 SQL 클라이언트로, 스키마 인식 IntelliSense와 위험한 명령문에 대한 안전장치를 갖추고 있습니다.