// 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. 用一条预处理语句配合绑定参数反复执行,一次插入多行,而不是拼出一条巨大的语句。

    INSERT INTO items (id, name) VALUES (?, ?);  -- prepare once, bind and run per row
  3. 检查你的绑定是否设置了更小的长度限制,如果合适就调大它。

相关错误

更多主要结果代码错误

代码和消息文本来自 SQLite 结果和错误代码文档。浏览完整的 SQLite 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 SQLite

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQLite 以及你使用的其他数据库。