错误代码搜索

SQLITE_IOERR_SEEK 错误代码是 SQLITE_IOERR 的扩展错误代码，指示 sqlite3_io_methods 对象上的 xRead 或 xWrite 方法在尝试将文件描述符查找到要发生读取或写入的文件的起始点时出现 I/O 错误。

不再使用 SQLITE_IOERR_SHMLOCK 错误代码。

SQLITE_IOERR_SHMMAP 错误代码是 SQLITE_IOERR 的扩展错误代码，指示在尝试将共享内存段映射到进程地址空间时 sqlite3_io_methods 对象上的 xShmMap 方法内出现 I/O 错误。

SQLITE_IOERR_SHMOPEN 错误代码是 SQLITE_IOERR 的扩展错误代码，指示在尝试打开新的共享内存段时 sqlite3_io_methods 对象上的 xShmMap 方法内出现 I/O 错误。

SQLITE_IOERR_SHMSIZE 错误代码是 SQLITE_IOERR 的扩展错误代码，指示在尝试扩大“shm”文件作为 WAL 模式事务处理的一部分时，sqlite3_io_methods 对象上的 xShmMap 方法内出现 I/O 错误。此错误可能表明底层文件系统卷空间不足。

SQLITE_IOERR_SHORT_READ 错误代码是 SQLITE_IOERR 的扩展错误代码，指示 VFS 层中的读取尝试无法获取请求的字节数。这可能是由于文件被截断造成的。

SQLITE_IOERR_TRUNCATE 错误代码是 SQLITE_IOERR 的扩展错误代码，指示在尝试使用 sqlite3_io_methods 对象的 xTruncate 方法更改文件大小时，VFS 层中出现 I/O 错误。

SQLITE_IOERR_UNLOCK 错误代码是 SQLITE_IOERR 的扩展错误代码，指示 sqlite3_io_methods 对象上的 xUnlock 方法内的 I/O 错误。

SQLITE_IOERR_VNODE 错误代码是保留供扩展使用的代码。 SQLite 核心不使用它。

SQLITE_IOERR_WRITE 错误代码是 SQLITE_IOERR 的扩展错误代码，指示尝试写入磁盘上的文件时 VFS 层中出现 I/O 错误。此错误可能是由于硬件故障或文件打开时文件系统被卸载所致。如果文件系统已满，则不应发生此错误，因为有一个单独的错误代码 (SQLITE_FULL) 用于此目的。

SQLITE_LOCKED 结果代码表示由于同一数据库连接内发生冲突或与使用共享缓存的不同数据库连接发生冲突，写入操作无法继续。 例如，当另一个线程正在同一数据库连接上读取该表时，无法运行 DROP TABLE 语句，因为删除该表会从并发读取器下删除该表。 SQLITE_LOCKED 结果代码与 SQLITE_BUSY 的不同之处在于，SQLITE_LOCKED 指示同一数据库连接（或与共享缓存的连接）上的冲突，而 SQLITE_BUSY 指示与不同数据库连接（可能在不同进程中）的冲突。

SQLITE_LOCKED_SHAREDCACHE 结果代码表示对 SQLite 数据记录的访问被在共享缓存模式下使用同一记录的另一个数据库连接阻止。当两个或多个数据库连接共享同一缓存并且其中一个连接正在修改该缓存中的记录时，其他连接将在修改正在进行时被阻止访问该数据，以防止读者看到损坏或部分完成的更改。

SQLITE_LOCKED_VTAB 结果代码不被 SQLite 核心使用，但可供扩展使用。虚拟表实现可以返回此结果代码，以指示由于其他线程或进程持有锁，它们无法完成当前操作。 当尝试更新 R-Tree 而另一个准备好的语句正在主动读取 R-Tree 时，R-Tree 扩展会返回此结果代码。更新无法继续，因为对 R-Tree 的任何更改都可能涉及节点的重新洗牌和重新平衡，这会破坏读取游标，导致某些行重复而其他行被省略。

SQLITE_MISMATCH 错误代码指示数据类型不匹配。 SQLite 通常非常宽容值的类型与存储该值的容器的声明类型之间的不匹配。例如，SQLite 允许应用程序将大型 BLOB 存储在声明类型为 BOOLEAN 的列中。但在某些情况下，SQLite 对类型很严格。当类型不匹配时，在少数情况下会返回 SQLITE_MISMATCH 错误。 表的 rowid 必须是整数。尝试将 rowid 设置为整数以外的任何值（或 NULL，它将自动转换为下一个可用的整数 rowid）会导致 SQLITE_MISMATCH 错误。

如果应用程序以未定义或不受支持的方式使用任何 SQLite 接口，则可能会返回 SQLITE_MISUSE 返回代码。例如，在准备好的语句完成后使用该准备好的语句可能会导致 SQLITE_MISUSE 错误。 SQLite 尝试使用此结果代码检测误用并报告误用。但是，不能保证滥用行为的检测会成功。误用检测是概率性的。应用程序永远不应该依赖于 SQLITE_MISUSE 返回值。 如果 SQLite 从任何接口返回 SQLITE_MISUSE，则意味着应用程序编码不正确，需要修复。不要发布有时从标准 SQLite 接口返回 SQLITE_MISUSE 的应用程序，因为该应用程序包含潜在的严重错误。

当数据库增长到大于文件系统可以处理的大小时，在不支持大文件的系统上可能会返回 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()的回调。这可以作为对应用程序设计者的警告：数据库可能会从附加索引中受益。