// 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()降低了限制,或者字符串连接导致长度超过限制。
如何修复它
-
将大型文件存储在数据库外部并保存其路径,或将内容拆分为跨行的块。
-
用一条预处理语句配合绑定参数反复执行,一次插入多行,而不是拼出一条巨大的语句。
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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQLite 以及你使用的其他数据库。