// 錯誤參考
SQLite 錯誤碼
官方清單中的所有 SQLite 結果碼,包括主要與延伸碼,並附有 sqlite3_errstr() 針對每個主要結果碼所傳回的值。你可能會遇到的結果碼都有一整頁的原因和解決方法。
解讀 SQLite 錯誤
SQLite 函式會傳回整數結果代碼。低八位是主要代碼,例如 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
|
字串或 BLOB 太大
18
字串或 BLOB 太大
|
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
|
hot journal(熱日誌)無法復原
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
|
主鍵條件約束失敗
1555
唯一約束失敗:orders.id
|
SQLITE_IOERR_FSTAT
|
1802
|
SQLITE_CONSTRAINT_TRIGGER
|
觸發器中的 RAISE() 中止了操作
1811
約束失敗
|
SQLITE_IOERR_UNLOCK
|
2058
|
SQLITE_CONSTRAINT_UNIQUE
|
唯一約束失敗
2067
唯一約束失敗: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
無法在 INTEGER 欄位 t.qty 中存放 TEXT 值
|
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,並為有風險的語句提供防護欄。