// SQLite 错误参考

SQLITE_FULL:数据库或磁盘已满

写入失败,因为磁盘或用于临时文件的分区已满,或者数据库达到其 max_page_count 限制。

结果代码
SQLITE_FULL
名称
13
类别
主要结果代码
错误信息
database or disk is full

它的意思

SQLITE_FULL (13) 表示 SQLite 因空间不足而无法完成写入。SQLite 文档指出了一个常见的意外情况:空间可能在临时目录而不是数据库所在的位置耗尽,因为大型排序、索引构建和 VACUUM 写临时文件,并且临时分区可能会小得多。

当数据库达到通过以下设置指定的页面限制时,会返回相同的代码: PRAGMA max_page_count.

常见原因

  • 存放数据库、其日志或 WAL 文件的磁盘已满。
  • 临时目录位于一个小分区(例如一个小 /tmp)和一个很大的 ORDER BY, CREATE INDEX 或者 VACUUM 填满了它。
  • PRAGMA max_page_count 限制数据库大小。
  • 由于检查点无法完成而变得非常大的 WAL 文件。

如何修复它

  1. 释放卷上的空间,或者将数据库移动到更大的卷上。

  2. 临时文件可以放到更大的目录,用的是 SQLITE_TMPDIR 或者 TMPDIR 环境变量,或者数据装得下就都放在内存里。

    PRAGMA temp_store = MEMORY;
  3. 检查分页限制,如有设置可将其调高。

    PRAGMA max_page_count;
    PRAGMA max_page_count = 2147483646;
  4. 在 WAL 模式下,等待读取完成后运行检查点以缩小 WAL。

    PRAGMA wal_checkpoint(TRUNCATE);

相关错误

更多主要结果代码错误

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

// 错误更少,修复更快

在 SQLly 中使用 SQLite

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