// SQLite 错误参考

SQLITE_NOMEM:内存不足

SQLite 无法分配继续所需的内存。通常是进程内存不足,或者堆限制设置过低。

结果代码
SQLITE_NOMEM
名称
7
类别
主要结果代码
错误信息
out of memory

它的意思

SQLITE_NOMEM (7)表示内部调用 sqlite3_malloc() 或者 sqlite3_realloc() 在需要内存才能继续时失败。SQLite 的设计就是在这一场景下干净地失败:回滚语句,不会损坏数据库。

常见原因

  • 进程或容器达到了其内存限制。
  • 一个软性或硬性堆上限,设置方式是 sqlite3_soft_heap_limit64() 或者 sqlite3_hard_heap_limit64(),或 PRAGMA hard_heap_limit.
  • 在内存中构建巨大结果的查询:排序或 GROUP BY 没有索引,或者 temp_store = MEMORY 拥有大量中间结果。
  • 一个非常大的 cache_size 设置。

如何修复它

  1. 检查进程或容器的内存限制,以及应用程序设置的堆限制。

    PRAGMA soft_heap_limit;
    PRAGMA hard_heap_limit;
  2. 让大型临时结果落盘而不是占用内存,并在页面缓存过大时将其调小。

    PRAGMA temp_store = FILE;
    PRAGMA cache_size = -64000;  -- about 64 MB
  3. 添加索引,让排序和分组无需把所有数据都放在内存里。

相关错误

更多主要结果代码错误

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

// 错误更少,修复更快

在 SQLly 中使用 SQLite

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