// SQLite 錯誤參考

SQLITE_TOOBIG:字串或 BLOB 過大

字串、BLOB 或 SQL 陳述式超過 SQLite 的限制(預設 1,000,000,000 位元組),或超過應用程式設定的較低上限。

結果代碼
SQLITE_TOOBIG
名稱
18
類別
主要結果代碼
錯誤訊息
string or blob too big

它的意義

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() ,或長到超過上限的字串串接。

如何修正

  1. 把大型檔案存放在資料庫之外並保留路徑,或將內容分塊存入多列。

  2. 以一個 prepared statement 搭配繫結參數反覆執行來插入多列,而不是組出一句超龐大的陳述式。

    INSERT INTO items (id, name) VALUES (?, ?);  -- prepare once, bind and run per row
  3. 檢查你的繫結是否設定了較低的長度上限,並在適當時調高。

相關錯誤

更多主要結果碼錯誤

程式碼和訊息文字來自 SQLite 結果代碼與錯誤碼文件。瀏覽完整的 SQLite 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 SQLite 和你使用的其他資料庫。