结果和错误代码

概述

SQLite C 语言接口 中的许多例程返回数字结果代码,指示成功或失败,并且在失败的情况下,提供失败原因的一些想法。本文档力图解释每个数字结果代码的含义。

1.结果代码与错误代码

“错误代码”是“结果代码”的子集,表示出现问题。只有几个非错误结果代码: SQLITE_OKSQLITE_ROWSQLITE_DONE术语“错误代码”是指除这三个之外的任何结果代码。

2.主要结果代码与扩展结果代码

结果代码是带符号的 32 位整数。结果代码的最低有效 8 位定义了一个广泛的类别,称为“主要结果代码”。更高有效位提供有关错误的更详细信息,称为“扩展结果代码”

请注意,主要结果代码始终是扩展结果代码的一部分。给定一个完整的 32 位扩展结果码,应用程序总能通过提取扩展结果码的最低 8 位来找到对应的主结果码。

所有扩展结果代码也是错误代码。因此,术语“扩展结果代码”和“扩展错误代码”是可以互换的。

为了历史兼容性,C 语言接口默认返回主要结果代码。可以使用sqlite3_extended_errcode()接口检索最近错误的扩展结果代码。sqlite3_extended_result_codes()接口可用于将数据库连接置于返回扩展结果代码而不是主要结果代码的模式。

3.定义

所有结果代码都是整数。所有结果代码的符号名称都是使用 sqlite3.h 头文件中的“#define”宏创建的。sqlite3.h 头文件中有单独的部分用于结果代码定义扩展结果代码定义

主要结果代码符号名称的格式为“SQLITE_XXXXXX”,其中 XXXXXX 是一系列大写字母字符。扩展结果代码名称的格式为“SQLITE_XXXXXX_YYYYYYY”,其中XXXXXX部分是对应的主要结果代码,YYYYYYY是对结果代码进一步分类的扩展。

现有结果代码的名称和数值是固定不变的。但是,新的结果代码,尤其是新的扩展结果代码,可能会出现在 SQLite 的未来版本中。

4.主要结果代码列表

sqlite3.h中定义了 31 个结果代码, 下面按字母顺序列出:

5.扩展结果代码列表

sqlite3.h中定义了74个扩展结果码,按字母顺序排列如下:

、结果码含义

所有 105 个结果代码值的含义如下所示,按数字顺序排列。

(0) SQLITE_OK

SQLITE_OK 结果代码表示操作成功并且没有错误。大多数其他结果代码表示错误。

(1) SQLITE_ERROR

SQLITE_ERROR 结果代码是一个通用错误代码,在没有其他更具体的错误代码可用时使用。

(2) SQLITE_INTERNAL

SQLITE_INTERNAL 结果代码表示内部故障。在 SQLite 的工作版本中,应用程序永远不会看到此结果代码。如果应用程序确实遇到此结果代码,则表明数据库引擎中存在错误。

SQLite 当前不生成此结果代码。但是,应用程序定义的 SQL 函数虚拟表VFSes或其他扩展可能会导致返回此结果代码。

(3) SQLITE_PERM

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

(4) SQLITE_ABORT

SQLITE_ABORT 结果代码表示操作在完成之前被中止,通常是应用程序请求。另请参阅:SQLITE_INTERRUPT

如果sqlite3_exec() 的回调函数返回非零值,则 sqlite3_exec() 将返回 SQLITE_ABORT。

如果ROLLBACK操作发生在与挂起的读取或写入相同的数据库连接上,则挂起的读取或写入可能会失败并出现 SQLITE_ABORT 或SQLITE_ABORT_ROLLBACK错误。

除了作为结果代码,SQLITE_ABORT 值还用作从sqlite3_vtab_on_conflict()接口 返回的冲突解决模式。

(5) SQLITE_BUSY

SQLITE_BUSY 结果代码表示由于某些其他数据库连接(通常是单独进程中的数据库连接 )的并发活动,无法写入(或在某些情况下读取)数据库文件。

例如,如果进程 A 正在处理一个大型写事务,同时进程 B 尝试启动一个新的写事务,则进程 B 将返回一个 SQLITE_BUSY 结果,因为 SQLite 一次只支持一个写入器。在开始新事务之前,进程 B 需要等待进程 A 完成其事务。sqlite3_busy_timeout ( )sqlite3_busy_handler()接口以及busy_timeout pragma可用于进程 B 以帮助它处理 SQLITE_BUSY 错误。

SQLITE_BUSY 错误可能发生在事务中的任何时候:事务首次启动时、任何写入或更新操作期间或事务提交时。为了避免在事务中间遇到 SQLITE_BUSY 错误,应用程序可以使用BEGIN IMMEDIATE而不是仅仅使用BEGIN来启动事务。BEGIN IMMEDIATE命令本身可能返回 SQLITE_BUSY,但如果成功,则 SQLite 保证通过下一个COMMIT对同一数据库的后续操作 不会返回 SQLITE_BUSY。

另请参阅: SQLITE_BUSY_RECOVERYSQLITE_BUSY_SNAPSHOT

SQLITE_BUSY 结果代码与SQLITE_LOCKED的不同之处在于,SQLITE_BUSY 表示与单独的数据库连接发生冲突,可能在单独的进程中,而SQLITE_LOCKED 表示在同一数据库连接(或有时与共享缓存的数据库连接)内发生冲突。

(6) SQLITE_LOCKED

SQLITE_LOCKED 结果代码表示由于同一数据库连接内的冲突或与使用共享缓存的不同数据库连接的冲突 ,写操作无法继续

例如,当另一个线程正在同一数据库连接上读取该表时,不能运行DROP TABLE语句,因为删除该表会将该表从并发读取器中删除。

SQLITE_LOCKED 结果代码与SQLITE_BUSY 的不同之处在于, SQLITE_LOCKED表示在同一数据库连接 (或与共享缓存的连接)上发生冲突,而SQLITE_BUSY表示与不同的数据库连接发生冲突,可能在不同的进程中。

(7) SQLITE_NOMEM

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

(8) SQLITE_READONLY

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

(9) SQLITE_INTERRUPT

SQLITE_INTERRUPT 结果代码表示操作被sqlite3_interrupt()接口中断。另见:SQLITE_ABORT

(10) SQLITE_IOERR

SQLITE_IOERR 结果代码表示操作无法完成,因为操作系统报告了 I/O 错误。

完整的磁盘驱动器通常会给出SQLITE_FULL错误而不是 SQLITE_IOERR 错误。

I/O 错误有许多不同的扩展结果代码,用于标识失败的特定 I/O 操作。

(11) SQLITE_CORRUPT

SQLITE_CORRUPT 结果代码表示数据库文件已损坏。有关损坏如何发生的进一步讨论, 请参阅如何损坏您的数据库文件。

(12)SQLITE_NOTFOUND

SQLITE_NOTFOUND 结果代码以三种方式公开:

  1. SQLITE_NOTFOUND 可以由sqlite3_file_control()接口返回,以指示作为第三个参数传递的文件控制操作码未被底层VFS识别。

  2. SQLITE_NOTFOUND 也可以由sqlite3_vfs对象的 xSetSystemCall() 方法返回。

  3. SQLITE_NOTFOUND 由sqlite3_vtab_rhs_value()返回,表示约束的右侧操作数不可用于进行调用的 xBestIndex 方法

SQLITE_NOTFOUND 结果代码也由 SQLite 实现在内部使用,但这些内部使用不会暴露给应用程序。

(13)SQLITE_FULL

SQLITE_FULL 结果代码表示写入无法完成,因为磁盘已满。请注意,尝试将信息写入主数据库文件时可能会发生此错误,也可能会在写入临时磁盘文件时发生。

有时即使主磁盘空间充足,应用程序也会遇到此错误,因为在临时文件存储在空间比主磁盘少得多的单独分区上的系统上 写入临时磁盘文件时会发生错误。

(14) SQLITE_CANTOPEN

SQLITE_CANTOPEN 结果代码表示 SQLite 无法打开文件。有问题的文件可能是主数据库文件或几个临时磁盘文件之一。

(15) SQLITE_PROTOCOL

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

(16) SQLITE_EMPTY

当前未使用 SQLITE_EMPTY 结果代码。

(17)SQLITE_SCHEMA

SQLITE_SCHEMA 结果代码表示数据库模式已更改。对于使用sqlite3_prepare()sqlite3_prepare16()生成准备好的语句,可以从sqlite3_step()返回此结果代码。如果数据库模式在语句准备和语句运行之间被其他进程更改,则可能会导致此错误。

如果从sqlite3_prepare_v2()生成准备好的语句,那么如果模式更改,语句将自动重新准备,最多 SQLITE_MAX_SCHEMA_RETRY次(默认值:50)。如果多次重试后失败仍然存在,sqlite3_step() 接口只会将 SQLITE_SCHEMA 返回给应用程序。

(18)SQLITE_TOOBIG

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 ,...) 设置。

(19) SQLITE_CONSTRAINT

SQLITE_CONSTRAINT 错误代码表示在尝试处理 SQL 语句时发生了 SQL 约束冲突。通过查阅随附的错误消息(通过sqlite3_errmsg()sqlite3_errmsg16()返回)或查看扩展错误代码,可以找到有关失败约束的其他信息

SQLITE_CONSTRAINT 代码也可以用作虚拟表实现的xBestIndex()方法的返回值。当 xBestIndex() 返回 SQLITE_CONSTRAINT 时,表示提交给 xBestIndex() 的特定输入组合无法生成可用的查询计划,不应进一步考虑。

(20)SQLITE_MISMATCH

SQLITE_MISMATCH 错误代码表示数据类型不匹配。

SQLite 通常对值的类型与存储该值的容器的声明类型之间的不匹配非常宽容。例如,SQLite 允许应用程序将大型 BLOB 存储在声明类型为 BOOLEAN 的列中。但在少数情况下,SQLite 对类型很严格。在类型不匹配的少数情况下,会返回 SQLITE_MISMATCH 错误。

表的rowid必须是一个整数。尝试将rowid设置 为整数以外的任何值(或将自动转换为下一个可用整数 rowid 的 NULL)会导致 SQLITE_MISMATCH 错误。

(21) SQLITE_MISUSE

如果应用程序以未定义或不受支持的方式使用任何 SQLite 接口,则可能会返回 SQLITE_MISUSE 返回码。例如,在准备好的语句完成后使用准备好的语句可能会导致 SQLITE_MISUSE 错误。

SQLite 尝试使用此结果代码检测误用并报告误用。但是,不能保证滥用检测一定会成功。误用检测是概率性的。应用程序不应该依赖于 SQLITE_MISUSE 返回值。

如果 SQLite 从任何接口返回 SQLITE_MISUSE,这意味着应用程序编码不正确,需要修复。不要发布有时会从标准 SQLite 接口返回 SQLITE_MISUSE 的应用程序,因为该应用程序包含潜在的严重错误。

(22)SQLITE_NOLFS

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

(23) SQLITE_AUTH

授权回调指示正在准备的 SQL 语句未被授权时,将返回 SQLITE_AUTH 错误。

(24) SQLITE_FORMAT

SQLITE 当前未使用 SQLITE_FORMAT 错误代码。

(25) SQLITE_RANGE

SQLITE_RANGE 错误指示 sqlite3_bind 例程之一的参数编号参数或 sqlite3_column 例程之一中 超出范围。

(26)SQLITE_NOTADB

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

(27) SQLITE_NOTICE

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

(28) SQLITE_WARNING

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

(100) SQLITE_ROW

sqlite3_step() 返回的 SQLITE_ROW 结果代码 表示有另一行输出可用。

(101) SQLITE_DONE

SQLITE_DONE 结果代码表示操作已完成。SQLITE_DONE 结果代码最常被视为sqlite3_step()的返回值,表示 SQL 语句已运行完成。但是 SQLITE_DONE 也可以由其他多步骤接口返回,例如sqlite3_backup_step()

[256] SQLITE_OK_LOAD_PERMANENTLY

sqlite3_load_extension()接口将扩展加载 单个数据库连接中。默认行为是在数据库连接关闭时自动卸载该扩展。但是,如果扩展入口点返回 SQLITE_OK_LOAD_PERMANENTLY 而不是 SQLITE_OK,那么在数据库连接关闭后扩展仍然加载到进程地址空间中。换句话说,当数据库连接关闭时,不会为扩展调用 sqlite3_vfs对象的 xDlClose 方法。

例如,SQLITE_OK_LOAD_PERMANENTLY 返回码对于 注册新VFSes的可加载扩展很有用。

【257】SQLITE_ERROR_MISSING_COLLSEQ

SQLITE_ERROR_MISSING_COLLSEQ 结果代码意味着无法准备 SQL 语句,因为无法找到该 SQL 语句中命名的整理序列。

有时遇到此错误代码时, sqlite3_prepare_v2()例程会将错误转换为 SQLITE_ERROR_RETRY并再次尝试使用不需要使用未知整理顺序的不同查询计划来准备 SQL 语句。

【261】SQLITE_BUSY_RECOVERY

SQLITE_BUSY_RECOVERY 错误代码是 SQLITE_BUSY 的 扩展错误代码,表示操作无法继续,因为另一个进程在崩溃后正忙于恢复WAL 模式数据库文件。SQLITE_BUSY_RECOVERY 错误代码仅出现在WAL 模式数据库上。

【262】SQLITE_LOCKED_SHAREDCACHE

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

(264) SQLITE_READONLY_RECOVERY

SQLITE_READONLY_RECOVERY 错误代码是 SQLITE_READONLY 的 扩展错误代码SQLITE_READONLY_RECOVERY错误码表示无法打开 WAL模式的数据库,因为需要恢复数据库文件,恢复需要写权限,但只有读权限可用。

【266】SQLITE_IOERR_READ

SQLITE_IOERR_READ 错误代码是 SQLITE_IOERR 的扩展错误代码 ,指示尝试从磁盘上的文件读取时VFS层中的 I/O 错误。此错误可能是由于硬件故障或文件系统在文件打开时被卸载引起的。

【267】SQLITE_CORRUPT_VTAB

SQLITE_CORRUPT_VTAB 错误代码是虚拟表使用的 SQLITE_CORRUPT扩展错误代码虚拟可能会返回 SQLITE_CORRUPT_VTAB 以指示虚拟表中的内容已损坏。

【270】SQLITE_CANTOPEN_NOTEMPDIR

不再使用 SQLITE_CANTOPEN_NOTEMPDIR 错误代码。

(275) SQLITE_CONSTRAINT_CHECK

SQLITE_CONSTRAINT_CHECK 错误代码是 SQLITE_CONSTRAINT 的扩展错误代码指示CHECK 约束失败。

(279) SQLITE_AUTH_USER

SQLITE_AUTH_USER 错误代码是 SQLITE_AUTH 的扩展错误代码指示已尝试对登录用户缺乏足够授权的数据库进行操作。

【283】SQLITE_NOTICE_RECOVER_WAL

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

【284】SQLITE_WARNING_AUTOINDEX

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

【513】SQLITE_ERROR_RETRY

SQLITE_ERROR_RETRY 在内部用于激发sqlite3_prepare_v2() (或其用于创建准备好的语句的同级例程之一)再次尝试准备在上一次尝试中因错误而失败的语句。

(516) SQLITE_ABORT_ROLLBACK

SQLITE_ABORT_ROLLBACK 错误代码是 SQLITE_ABORT 的扩展错误代码指示 SQL 语句中止,因为 SQL 语句首次启动时处于活动状态的事务被回滚。当发生回滚时,挂起的写操作总是失败并出现此错误。仅当模式在被回滚的事务中更改时, ROLLBACK才会导致挂起的读取操作失败。

(517) SQLITE_BUSY_SNAPSHOT

SQLITE_BUSY_SNAPSHOT 错误代码是 SQLITE_BUSY 的扩展错误代码当数据库连接试图将读取事务提升为写入事务但发现另一个数据库连接已写入数据库并因此使先前的读取无效 时,它会在WAL 模式数据库上发生。

以下场景说明了如何出现 SQLITE_BUSY_SNAPSHOT 错误:

  1. 进程 A 在数据库上启动读取事务并执行一个或多个 SELECT 语句。进程 A 保持事务打开。
  2. 进程 B 更新数据库,更改进程 A 先前读取的值。
  3. 进程 A 现在尝试写入数据库。但是进程 A 的数据库内容视图现在已经过时,因为进程 B 在进程 A 读取数据库文件后修改了它。因此进程 A 收到 SQLITE_BUSY_SNAPSHOT 错误。

【518】SQLITE_LOCKED_VTAB

SQLITE_LOCKED_VTAB 结果代码不被 SQLite 核心使用,但它可供扩展使用。虚拟表实现可以返回此结果代码以指示它们由于其他线程或进程持有的锁而无法完成当前操作。

尝试更新 R-Tree 而另一个准备好的语句正在主动读取 R-Tree 时, R-Tree 扩展返回此结果代码。更新无法继续,因为对 R-Tree 的任何更改都可能涉及节点的重新洗牌和重新平衡,这会破坏读取游标,导致重复某些行并省略其他行。

【520】SQLITE_READONLY_CANTLOCK

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

【522】SQLITE_IOERR_SHORT_READ

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

【523】SQLITE_CORRUPT_SEQUENCE

SQLITE_CORRUPT_SEQUENCE 结果代码表示 sqlite_sequence 表的模式已损坏。sqlite_sequence 表用于帮助实现AUTOINCREMENT功能。sqlite_sequence 表应具有以下格式:

  CREATE TABLE sqlite_sequence(name,seq);
  

如果 SQLite 发现 sqlite_sequence 表有任何其他格式,它会返回 SQLITE_CORRUPT_SEQUENCE 错误。

【526】SQLITE_CANTOPEN_ISDIR

SQLITE_CANTOPEN_ISDIR 错误代码是 SQLITE_CANTOPEN 的扩展错误代码表示文件打开操作失败,因为该文件实际上是一个目录。

(531) SQLITE_CONSTRAINT_COMMITHOOK

SQLITE_CONSTRAINT_COMMITHOOK 错误代码是 SQLITE_CONSTRAINT 的扩展错误代码表示 提交挂钩回调返回非零值,从而导致 SQL 语句回滚。

(539) SQLITE_NOTICE_RECOVER_ROLLBACK

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

【769】SQLITE_ERROR_快照

尝试使用sqlite3_snapshot_open()接口 在数据库的历史版本上启动读取事务时,可能会返回 SQLITE_ERROR_SNAPSHOT 结果代码。如果历史快照不再可用,则读取事务将失败并返回 SQLITE_ERROR_SNAPSHOT。仅当使用-DSQLITE_ENABLE_SNAPSHOT编译 SQLite 时才会出现此错误代码

(773)SQLITE_BUSY_TIMEOUT

SQLITE_BUSY_TIMEOUT 错误代码表示 VFS 层中的阻塞 Posix 咨询文件锁定请求因超时而失败。阻塞 Posix 建议锁只能作为专有的 SQLite 扩展使用,即便如此,也只有在使用 SQLITE_EANBLE_SETLK_TIMEOUT 编译时选项编译 SQLite 时才受支持。

(776) SQLITE_READONLY_ROLLBACK

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

(778) SQLITE_IOERR_WRITE

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

(779)SQLITE_CORRUPT_INDEX

SQLITE_CORRUPT_INDEX 结果代码表示 SQLite 检测到一个条目在索引中丢失或丢失。这是SQLITE_CORRUPT错误代码的一个特例,表明该问题可以通过运行REINDEX命令来解决,假设数据库文件中的其他地方不存在其他问题。

【782】SQLITE_CANTOPEN_FULLPATH

SQLITE_CANTOPEN_FULLPATH 错误代码是 SQLITE_CANTOPEN 的扩展错误代码表示文件打开操作失败,因为操作系统无法将文件名转换为完整路径名。

【787】SQLITE_CONSTRAINT_FOREIGNKEY

SQLITE_CONSTRAINT_FOREIGNKEY 错误代码是 SQLITE_CONSTRAINT 的扩展错误代码表示外键约束失败。

【1032】SQLITE_READONLY_DBMOVED

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

【1034】SQLITE_IOERR_FSYNC

SQLITE_IOERR_FSYNC 错误代码是 SQLITE_IOERR 的扩展错误代码 ,指示VFS层中的 I/O 错误,同时尝试将先前写入的内容从操作系统和/或磁盘控制缓冲区刷新到持久存储中。换句话说,此代码表明 unix 中的 fsync() 系统调用或 windows 中的 FlushFileBuffers() 系统调用存在问题。

【1038】SQLITE_CANTOPEN_CONVPATH

SQLITE_CANTOPEN_CONVPATH 错误代码是 SQLITE_CANTOPEN 的扩展错误代码仅由 Cygwin VFS使用,表示尝试打开文件时 cygwin_conv_path() 系统调用失败。另见:SQLITE_IOERR_CONVPATH

(1043) SQLITE_CONSTRAINT_FUNCTION

SQLITE_CONSTRAINT_FUNCTION 错误代码当前未被 SQLite 核心使用。但是,此错误代码可供扩展功能使用。

【1288】SQLITE_READONLY_CANTINIT

SQLITE_READONLY_CANTINIT结果码来源于VFS的xShmMap方法,表示WAL模式使用的共享内存区 存在,但由于当前进程没有共享内存区的写权限,其内容不可靠,无法被当前进程使用。(WAL 模式的共享内存区域通常是一个映射到进程空间的带有“-wal”后缀的文件。如果当前进程对该文件没有写权限,那么它不能写入共享内存。)

SQLite 中更高级别的逻辑通常会拦截错误代码并创建一个临时的内存共享内存区域,以便当前进程至少可以读取数据库的内容。此结果代码不应到达应用程序接口层。

【1290】SQLITE_IOERR_DIR_FSYNC

SQLITE_IOERR_DIR_FSYNC 错误代码是 SQLITE_IOERR 的扩展错误代码 ,指示尝试在目录上调用 fsync() 时VFS层中的 I/O 错误。unix VFS在创建或删除某些文件后尝试 fsync() 目录,以确保这些文件在断电或系统崩溃后仍会出现在文件系统中。此错误代码表示尝试执行该 fsync() 时出现问题。

【1294】 SQLITE_CANTOPEN_DIRTYWAL

此时不使用 SQLITE_CANTOPEN_DIRTYWAL 结果代码。

【1299】SQLITE_CONSTRAINT_NOTNULL

SQLITE_CONSTRAINT_NOTNULL 错误代码是 SQLITE_CONSTRAINT 的扩展错误代码表示NOT NULL 约束失败。

(1544)SQLITE_READONLY_DIRECTORY

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

(1546) SQLITE_IOERR_TRUNCATE

SQLITE_IOERR_TRUNCATE 错误代码是 SQLITE_IOERR 的扩展错误代码 ,指示在尝试将文件截断为更小尺寸时 VFS层中的 I/O 错误。

(1550)SQLITE_CANTOPEN_SYMLINK

当使用SQLITE_OPEN_NOFOLLOW标志并且数据库文件是符号链接 时 ,SQLITE_CANTOPEN_SYMLINK 结果代码由 sqlite3_open()接口及其兄弟 返回。

【1555】SQLITE_CONSTRAINT_PRIMARYKEY

SQLITE_CONSTRAINT_PRIMARYKEY 错误代码是 SQLITE_CONSTRAINT 的扩展错误代码指示PRIMARY KEY 约束失败。

【1802】SQLITE_IOERR_FSTAT

SQLITE_IOERR_FSTAT 错误代码是 SQLITE_IOERR 的扩展错误代码 ,指示在尝试调用文件上的 fstat()(或等效函数)以确定文件大小或访问权限等信息时 VFS层中的 I/O 错误。

(1811)SQLITE_CONSTRAINT_TRIGGER

SQLITE_CONSTRAINT_TRIGGER 错误代码是 SQLITE_CONSTRAINT 的扩展错误代码表示触发了触发器中的RAISE 函数,导致 SQL 语句中止。

(2058) SQLITE_IOERR_UNLOCK

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

【2067】SQLITE_CONSTRAINT_UNIQUE

SQLITE_CONSTRAINT_UNIQUE 错误代码是 SQLITE_CONSTRAINT 的扩展错误代码表示UNIQUE 约束失败。

【2314】SQLITE_IOERR_RDLOCK

SQLITE_IOERR_UNLOCK 错误代码是 SQLITE_IOERR 的扩展错误代码 ,指示在尝试获取读锁时 sqlite3_io_methods对象上的 xLock 方法内发生 I/O 错误。

【2323】SQLITE_CONSTRAINT_VTAB

SQLITE_CONSTRAINT_VTAB 错误代码当前未被 SQLite 核心使用。但是,此错误代码可供应用程序定义的虚拟表使用。

【2570】SQLITE_IOERR_DELETE

SQLITE_IOERR_UNLOCK 错误代码是 SQLITE_IOERR 的扩展错误代码 ,指示sqlite3_vfs对象 上的 xDelete 方法中的 I/O 错误。

【2579】SQLITE_CONSTRAINT_ROWID

SQLITE_CONSTRAINT_ROWID 错误代码是 SQLITE_CONSTRAINT 的扩展错误代码表示rowid不是唯一的。

【2826】SQLITE_IOERR_BLOCKED

不再使用 SQLITE_IOERR_BLOCKED 错误代码。

【2835】SQLITE_CONSTRAINT_PINNED

SQLITE_CONSTRAINT_PINNED 错误代码是 SQLITE_CONSTRAINT 的扩展错误代码表示更新触发器尝试删除在更新过程中正在更新的行。

【3082】SQLITE_IOERR_NOMEM

SQLITE_IOERR_NOMEM 错误代码有时由VFS 层返回,表示由于无法分配足够的内存而无法完成操作。在返回给应用程序之前, 此错误代码通常由 SQLite 的更高层转换为SQLITE_NOMEM 。

【3091】SQLITE_CONSTRAINT_DATATYPE

SQLITE_CONSTRAINT_DATATYPE 错误代码是 SQLITE_CONSTRAINT 的扩展错误代码指示插入或更新尝试将与列声明类型不一致的值存储在定义为 STRICT 的表中。

(3338) SQLITE_IOERR_ACCESS

SQLITE_IOERR_ACCESS 错误代码是 SQLITE_IOERR 的扩展错误代码 ,指示sqlite3_vfs对象 上的 xAccess 方法内的 I/O 错误。

【3594】SQLITE_IOERR_CHECKRESERVEDLOCK

SQLITE_IOERR_CHECKRESERVEDLOCK 错误代码是 SQLITE_IOERR 的扩展错误代码 ,指示sqlite3_io_methods对象 上的 xCheckReservedLock 方法中的 I/O 错误。

(3850)SQLITE_IOERR_LOCK

SQLITE_IOERR_LOCK 错误代码是 SQLITE_IOERR 的扩展错误代码指示咨询文件锁定逻辑中的 I/O 错误。通常 SQLITE_IOERR_LOCK 错误表示获取PENDING 锁时出现问题。但是,它也可以指示 Mac 上使用的某些专用VFS上的杂项锁定错误。

(4106) SQLITE_IOERR_CLOSE

SQLITE_IOERR_ACCESS 错误代码是 SQLITE_IOERR 的扩展错误代码 ,指示sqlite3_io_methods对象 的 xClose 方法中的 I/O 错误。

(4362)SQLITE_IOERR_DIR_CLOSE

不再使用 SQLITE_IOERR_DIR_CLOSE 错误代码。

【4618】SQLITE_IOERR_SHMOPEN

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

(4874)SQLITE_IOERR_SHMSIZE

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

(5130)SQLITE_IOERR_SHMLOCK

不再使用 SQLITE_IOERR_SHMLOCK 错误代码。

【5386】SQLITE_IOERR_SHMMAP

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

(5642)SQLITE_IOERR_SEEK

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

(5898)SQLITE_IOERR_DELETE_NOENT

SQLITE_IOERR_DELETE_NOENT错误码是SQLITE_IOERR的扩展错误码 ,表示sqlite3_vfs对象上的xDelete方法失败,因为被删除的文件不存在。

(6154)SQLITE_IOERR_MMAP

SQLITE_IOERR_MMAP 错误代码是 SQLITE_IOERR 的扩展错误代码 ,指示在尝试将数据库文件的一部分映射或取消映射到进程地址空间时 , sqlite3_io_methods对象上的 xFetch 或 xUnfetch 方法内发生 I/O 错误。

(6410)SQLITE_IOERR_GETTEMPPATH

SQLITE_IOERR_GETTEMPPATH 错误代码是 SQLITE_IOERR 的扩展错误代码表示VFS无法确定放置临时文件的合适目录。

(6666)SQLITE_IOERR_CONVPATH

SQLITE_IOERR_CONVPATH 错误代码是 SQLITE_IOERR 的扩展错误代码 ,仅供Cygwin VFS使用,表示 cygwin_conv_path() 系统调用失败另见:SQLITE_CANTOPEN_CONVPATH

(6922) SQLITE_IOERR_VNODE

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

(7178)SQLITE_IOERR_AUTH

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

(7434)SQLITE_IOERR_BEGIN_ATOMIC

SQLITE_IOERR_BEGIN_ATOMIC 错误代码表示底层操作系统在 SQLITE_FCNTL_BEGIN_ATOMIC_WRITE文件控制上报告错误。这仅在启用SQLITE_ENABLE_ATOMIC_WRITE并且数据库托管在支持原子写入的文件系统上时出现。

(7690)SQLITE_IOERR_COMMIT_ATOMIC

SQLITE_IOERR_COMMIT_ATOMIC 错误代码表示底层操作系统在 SQLITE_FCNTL_COMMIT_ATOMIC_WRITE文件控制上报告错误。这仅在启用SQLITE_ENABLE_ATOMIC_WRITE并且数据库托管在支持原子写入的文件系统上时出现。

(7946)SQLITE_IOERR_ROLLBACK_ATOMIC

SQLITE_IOERR_ROLLBACK_ATOMIC 错误代码表示底层操作系统在 SQLITE_FCNTL_ROLLBACK_ATOMIC_WRITE文件控制上报告错误。这仅在启用SQLITE_ENABLE_ATOMIC_WRITE并且数据库托管在支持原子写入的文件系统上时出现。

(8202) SQLITE_IOERR_DATA

SQLITE_IOERR_DATA 错误代码是 SQLITE_IOERR 的扩展错误代码仅由校验和 VFS 填充程序使用,以指示数据库文件页面上的校验和不正确。

(8458)SQLITE_IOERR_CORRUPTFS

SQLITE_IOERR_CORRUPTFS 错误代码是 SQLITE_IOERR 的扩展错误代码仅由 VFS 使用以指示查找或读取失败是由于请求未落在文件边界内而不是普通设备故障。这通常表示文件系统损坏。