// 錯誤參考

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_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,並為有風險的語句提供防護欄。