SQLite 错误代码

当数据库增长到大于文件系统可以处理的大小时，在不支持大文件的系统上可能会返回 SQLITE_NOLFS 错误。 “NOLFS”代表“不支持大文件”。

SQLITE_NOMEM 结果代码表明 SQLite 无法分配完成操作所需的所有内存。换句话说，在需要分配内存才能继续操作的情况下，对 sqlite3_malloc() 或 sqlite3_realloc() 的内部调用失败。

尝试打开文件时，SQLITE_NOTADB 错误表明正在打开的文件似乎不是 SQLite 数据库文件。

SQLITE_NOTFOUND 结果代码通过三种方式公开： SQLITE_NOTFOUND 结果代码也由 SQLite 实现在内部使用，但这些内部用途不会公开给应用程序。

任何 C/C++ 接口都不会返回 SQLITE_NOTICE 结果代码。然而，SQLITE_NOTICE（或者更确切地说，它的扩展错误代码之一）有时被用作 sqlite3_log() 回调中的第一个参数，以指示正在发生异常操作。

当热日志回滚时，SQLITE_NOTICE_RECOVER_ROLLBACK结果代码将传递给sqlite3_log()的回调。

当恢复 WAL 模式数据库文件时，SQLITE_NOTICE_RECOVER_WAL 结果代码将传递给 sqlite3_log() 的回调。

SQLITE_PERM 结果代码表示无法为新创建的数据库提供请求的访问模式。

SQLITE_PROTOCOL 结果代码指示 SQLite 使用的文件锁定协议存在问题。 SQLITE_PROTOCOL 错误当前仅在使用 WAL 模式并尝试启动新事务时返回。当两个单独的数据库连接都尝试在 WAL 模式下同时启动事务时，可能会出现竞争条件。比赛的失败者在短暂的延迟后后退并再次尝试。如果同一个连接在几秒内多次失去锁定竞争，它最终将放弃并返回 SQLITE_PROTOCOL。 SQLITE_PROTOCOL 错误在实践中应该非常非常罕见，并且仅当有许多单独的进程都激烈竞争写入同一数据库时才出现。

SQLITE_RANGE 错误索引表示 sqlite3_bind 例程之一的参数号参数或 sqlite3_column 例程之一中的列号超出范围。

当尝试更改当前数据库连接没有写入权限的某些数据时，将返回 SQLITE_READONLY 结果代码。

SQLITE_READONLY_CANTINIT结果代码源自VFS的xShmMap方法，表示WAL模式使用的共享内存区域存在，但其内容不可靠且无法被当前进程使用，因为当前进程没有对该共享内存区域的写权限。 （WAL模式的共享内存区域通常是一个带有“-wal”后缀的文件，该文件被映射到进程空间。如果当前进程对该文件没有写权限，则无法写入共享内存。） SQLite 中的高层逻辑通常会拦截错误代码并创建一个临时的内存共享内存区域，以便当前进程至少可以读取数据库的内容。该结果代码不应到达应用程序接口层。

SQLITE_READONLY_CANTLOCK 错误代码是 SQLITE_READONLY 的扩展错误代码。 SQLITE_READONLY_CANTLOCK 错误代码表示 SQLite 无法获取 WAL 模式数据库上的读锁，因为与该数据库关联的共享内存文件是只读的。

SQLITE_READONLY_DBMOVED 错误代码是 SQLITE_READONLY 的扩展错误代码。 SQLITE_READONLY_DBMOVED 错误代码表示无法修改数据库，因为数据库文件自打开以来已被移动，因此如果进程崩溃，则任何修改数据库的尝试都可能导致数据库损坏，因为回滚日志无法正确命名。

SQLITE_READONLY_DIRECTORY结果代码表明数据库是只读的，因为进程没有权限在与数据库相同的目录中创建日志文件，而创建日志文件是写入的前提条件。

SQLITE_READONLY_RECOVERY 错误代码是 SQLITE_READONLY 的扩展错误代码。 SQLITE_READONLY_RECOVERY错误代码表示无法打开WAL模式数据库，因为数据库文件需要恢复，并且恢复需要写访问权限，但只能进行读访问。

SQLITE_READONLY_ROLLBACK 错误代码是 SQLITE_READONLY 的扩展错误代码。 SQLITE_READONLY_ROLLBACK错误代码表示数据库无法打开，因为它有一个需要回滚的热日志，但由于数据库是只读的而无法打开。

SQLITE_SCHEMA 结果代码指示数据库架构已更改。对于使用 sqlite3_prepare() 或 sqlite3_prepare16() 生成的准备好的语句，可以从 sqlite3_step() 返回此结果代码。如果在准备语句和运行语句之间数据库架构被其他进程更改，则可能会导致此错误。 如果准备好的语句是从 sqlite3_prepare_v2() 生成的，那么当模式发生更改时，该语句会自动重新准备，最多 SQLITE_MAX_SCHEMA_RETRY 次（默认值：50）。如果在多次重试后失败仍然存在，sqlite3_step() 接口只会将 SQLITE_SCHEMA 返回给应用程序。

SQLITE_TOOBIG 错误代码指示字符串或 BLOB 太大。 SQLite 中字符串或 BLOB 的默认最大长度为 1,000,000,000 字节。这个最大长度可以在编译时使用 SQLITE_MAX_LENGTH 编译时选项进行更改，或者在运行时使用 sqlite3_limit(db,SQLITE_LIMIT_LENGTH,...) 接口进行更改。当 SQLite 遇到超出编译时或运行时限制的字符串或 BLOB 时，会产生 SQLITE_TOOBIG 错误。 当将过大的 SQL 语句传递到 sqlite3_prepare_v2() 接口之一时，也会导致 SQLITE_TOOBIG 错误代码。 SQL 语句的最大长度默认为类似的值 1,000,000,000 字节。最大 SQL 语句长度可以在编译时使用 SQLITE_MAX_SQL_LENGTH 设置，或在运行时使用 sqlite3_limit(db,SQLITE_LIMIT_SQL_LENGTH,...) 设置。

任何 C/C++ 接口都不会返回 SQLITE_WARNING 结果代码。然而，SQLITE_WARNING（或者更确切地说，它的扩展错误代码之一）有时被用作 sqlite3_log() 回调中的第一个参数，以指示正在发生不寻常且可能不明智的操作。

每当使用自动索引时，SQLITE_WARNING_AUTOINDEX结果代码都会传递给sqlite3_log()的回调。这可以作为对应用程序设计者的警告：数据库可能会从附加索引中受益。