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_CANTOPEN_SYMLINK
|
1550
|
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와 위험한 명령문에 대한 안전장치를 갖추고 있습니다.