// SQLite 錯誤參考
SQLITE_TOOBIG:字串或 BLOB 過大
字串、BLOB 或 SQL 陳述式超過 SQLite 的限制(預設 1,000,000,000 位元組),或超過應用程式設定的較低上限。
- 結果代碼
SQLITE_TOOBIG- 名稱
18- 類別
- 主要結果代碼
它的意義
SQLITE_TOOBIG (18) 會在字串或 BLOB 超過最大長度時回傳;上限在編譯時以 SQLITE_MAX_LENGTH (預設 1,000,000,000 位元組),或在執行階段用 sqlite3_limit(db, SQLITE_LIMIT_LENGTH, ...)。過大的 SQL 陳述式也會得到同樣的錯誤;其上限為 SQLITE_MAX_SQL_LENGTH / SQLITE_LIMIT_SQL_LENGTH。超過長度限制的資料列也會失敗。
常見原因
- 在單一 BLOB 或 TEXT 值中儲存非常大的檔案或文件。
- 組成一句超大的 SQL 語句,例如多列的
INSERT並支援數百萬個字面值。 - 某個應用程式或繫結程式用
sqlite3_limit(). - A
group_concat(),或長到超過上限的字串串接。
如何修正
-
把大型檔案存放在資料庫之外並保留路徑,或將內容分塊存入多列。
-
以一個 prepared statement 搭配繫結參數反覆執行來插入多列,而不是組出一句超龐大的陳述式。
INSERT INTO items (id, name) VALUES (?, ?); -- prepare once, bind and run per row
-
檢查你的繫結是否設定了較低的長度上限,並在適當時調高。
相關錯誤
更多主要結果碼錯誤
SQLITE_ERRORSQL 邏輯錯誤SQLITE_PERM存取權限遭拒SQLITE_ABORT查詢已中止SQLITE_BUSY資料庫已鎖定SQLITE_LOCKED資料庫資料表已鎖定SQLITE_NOMEM記憶體不足SQLITE_READONLY嘗試寫入唯讀資料庫SQLITE_INTERRUPT已中斷
程式碼和訊息文字來自 SQLite 結果代碼與錯誤碼文件。瀏覽完整的 SQLite 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 SQLite
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 SQLite 和你使用的其他資料庫。