字段 sqlca.sqlstate 和 sqlca.sqlcode 是提供错误代码的两种不同的模式。两种源自 SQL,但是 SQLCODE 在 1992 年的标准版本里标注为废弃的, 并且在 1999 年版本里被删除了。因此,对于新应用,我们强烈建议使用 SQLSTATE。
SQLSTATE 是一个五字符的数组。五个字符包含数值或者大写字母, 代表各种错误或者警告条件的代码。SQLSTATE 有个层次化的模式:头两个字符标识条件的通常表示错误条件的类别, 后三个字符表示在该通用类中的子类。成功的状态是由 00000 标识的。SQLSTATE 代码在大多数地方都是定义在 SQL 标准里的。PostgreSQL 服务器本机支持 SQLSTATE 错误代码;因此在应用里使用这个错误代码模式可以实现非常高的一致性。更多信息请参阅 。
SQLCODE 是废弃的错误代码模式,是一个简单的整数。 0 标识成功,正数标识带着额外信息的成功,负数表示一个错误。SQL 标准只定义了正数值 +100, 这个表示{zh1}的命令返回零行或者影响了零行,并且没有特定的负数值。 因此,这个模式只能实现很有限的一致性并且并没有一个层次化的代码机制。 历史上,PostgreSQL 的嵌入的 SQL 处理器为自己使用赋予了一些 SQLCODE 的数值,这些都在下面列出,包括他们的数值和符号名。记住这些是不能移植到其它 SQL 实现中去的。 为了简化应用向 SQLSTATE 模式的移植,我们还列出了 SQLSTATE。 不过,这两个模式之间没有一对一或者一对多的映射(包括多对多),所以在任何情况下你都应该参考在 里列出的全局SQLSTATE。
这些是已经赋值的 SQLCODE 数值:
- -12 (ECPG_OUT_OF_MEMORY)
-
表明你的虚拟内存已经耗尽(SQLSTATE YE001)
- -200 (ECPG_UNSUPPORTED)
-
表明预处理器生成了一些库不知道的东西。可能你运行的预处理器版本和库版本不同。(SQLSTATE YE002)
- -201 (ECPG_TOO_MANY_ARGUMENTS)
-
这意味着你的命令声明了比命令预期要多的宿主变量(SQLSTATE 07001 或者 07002)
- -202 (ECPG_TOO_FEW_ARGUMENTS)
-
这意味着你的命令声明了比命令预期要少的宿主变量(SQLSTATE 07001 或者 07002)
- -203 (ECPG_TOO_MANY_MATCHES)
-
这意味着查询返回了多行,但是语句只准备存储一行结果(比如,因为声明的变量不是数组)。(SQLSTATE 21000)
- -204 (ECPG_INT_FORMAT)
-
宿主变量是 int 类型,而数据库里的数据是其它类型, 并且包含无法解释成 int 类型的数值。库使用 strtol() 做这种转换。(SQLSTATE 42804)
- -205 (ECPG_UINT_FORMAT)
-
宿主变量是 unsigned int 而数据库里的数据是其它类型, 并且包含无法解释成 unsigned int 类型的数值。 库使用 strtoul() 做这种转换。(SQLSTATE 42804)
- -206 (ECPG_FLOAT_FORMAT)
-
宿主变量是 float 而数据库里的数据是其它类型, 并且包含无法解释成 float 类型的数值。 库使用 strtod() 做这种转换。(SQLSTATE 42804)
- -207 (ECPG_CONVERT_BOOL)
-
这意味着宿主变量是类型为 bool 的而数据库中的数据既不是't' 也不是 'f'。(SQLSTATE 42804)
- -208 (ECPG_EMPTY)
-
发送给 PostgreSQL 服务器的语句是空的。 (这个通常不能在嵌入 SQL 程序里出现,因此它可能是一个内部错误。) (SQLSTATE YE002)
- -209 (ECPG_MISSING_INDICATOR)
-
返回了一个空值,但是没有提供空值指示器变量。(SQLSTATE 22002)
- -210 (ECPG_NO_ARRAY)
-
在一个需要数组的地方使用了一个普通变量。(SQLSTATE 42804)
- -211 (ECPG_DATA_NOT_ARRAY)
-
在一个需要数组的地方数据库返回了一个普通变量。 (SQLSTATE 42804)
- -220 (ECPG_NO_CONN)
-
程序视图访问一个不存在的连接。(SQLSTATE 08003)
- -221 (ECPG_NOT_CONN)
-
程序视图访问一个存在但未打开的连接(这是一个内部错误。)(SQLSTATE YE002)
- -230 (ECPG_INVALID_STMT)
-
你正在尝试使用的语句还没准备好。(SQLSTATE 26000)
- -240 (ECPG_UNKNOWN_DESCRIPTOR)
-
声明的描述符没有找到。你在试图使用的语句没有准备好(SQLSTATE 33000)
- -241 (ECPG_INVALID_DESCRIPTOR_INDEX)
-
声明的描述符索引超出范围。(SQLSTATE 07009)
- -242 (ECPG_UNKNOWN_DESCRIPTOR_ITEM)
-
请求了一个非法的描述符项。(这是一个内部错误。)(SQLSTATE YE002)
- -243 (ECPG_VAR_NOT_NUMERIC)
-
在一个动态语句的执行的过程中,数据库返回了一个数字只,而宿主变量不是数值型(SQLSTATE 07006)。
- -244 (ECPG_VAR_NOT_CHAR)
-
在执行一个动态语句的过程中,数据库返回了一个非数字数值,但是宿主变量是数值型。(SQLSTATE 07006)
- -400 (ECPG_PGSQL)
-
一些 PostgreSQL 服务器导致的错误。 消息包含来自 PostgreSQL 服务器的错误消息。
- -401 (ECPG_TRANS)
-
PostgreSQL 告诉我们不能启动,提交, 或者回滚这个事务。(SQLSTATE 08007)
- -402 (ECPG_CONNECT)
-
与数据库的连接企图没有成功(SQLSTATE 08001)。
- 100 (ECPG_NOT_FOUND)
-
这是个无害的条件,表示{zh1}一条命令检索或者处理了零行,或者你在游标的结尾。(SQLSTATE 02000)