云数据库 GaussDB-SQLSTATE与SQLCODE
下载云数据库 GaussDB用户手册完整版
SQLSTATE与SQLCODE
SQLSTATE是一个由五个字符组成的数组。这五个字符包含数字或大写字母，它表示多种错误或告警情况的代码。SQLSTATE具有一种层次模式：前两个字符表示情况的总体分类，后三个字符表示总体情况的子类。例如：代码00000表示成功状态。
SQLCODE是一个简单的整数形式。值为0表示成功，一个正值表示带附加信息的成功，一个负值表示错误。SQL标准只定义了正值+100，它表示上一个命令返回或者影响了零行，且没有特定的负值。
SQLCODE值 |
SQLSTATE值 |
含义 |
|---|---|---|
0 (ECPG_NO_ERROR) |
SQLSTATE 00000 |
表示没有错误。 |
100 (ECPG_NOT_FOUND) |
SQLSTATE 02000 |
一种无害情况，它表示上一个命令检索或者处理了零行，或者已到达游标的末尾。
在循环中处理游标时，可以使用这个代码来检测何时中止该循环，示例如下：
while (1) { EXEC SQL FETCH ... ; if (sqlca.sqlcode == ECPG_NOT_FOUND) break; }
实际上WHENEVER NOT FOUND DO BREAK也会在内部这样做，所以一般不会直接使用这种方法。 |
-12 (ECPG_OUT_OF_MEMORY) |
SQLSTATE YE001 |
虚拟内存已被耗尽，数字值被定义为-ENOMEM。 |
-200 (ECPG_UNSUPPORTED) |
SQLSTATE YE000 |
预处理器产生了一些该库无法识别的内容。 |
-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) |
SQLSTATE 42804 |
宿主变量是类型int而数据库中的数据是一种不同的类型并且含有不能被解释为int的值。该库使用strtol()进行这种转换。 |
-205 (ECPG_UINT_FORMAT) |
SQLSTATE 42804 |
宿主变量是类型unsigned int而数据库中的数据是一种不同的类型并且含有不能被解释为unsigned int的值。该库使用strtoul()进行这种转换。 |
-206 (ECPG_FLOAT_FORMAT) |
SQLSTATE 42804 |
宿主变量是类型float而数据库中的数据是另一种类型并且含有不能被解释为float的值。该库使用strtod()进行这种转换。 |
-207 (ECPG_NUMERIC_FORMAT) |
SQLSTATE 42804 |
宿主变量是类型numeric而数据库中的数据是另一种类型并且含有不能被解释为numeric的值。 |
-208 (ECPG_INTERVAL_FORMAT) |
SQLSTATE 42804 |
宿主变量是类型interval而数据库中的数据是另一种类型并且含有一个不能被解释为interval的值。 |
-209 (ECPG_DATE_FORMAT) |
SQLSTATE 42804 |
宿主变量是类型date而数据库中的数据是另一种类型并且含有不能被解释为date的值。 |
-210 (ECPG_TIMESTAMP_FORMAT) |
SQLSTATE 42804 |
宿主变量是类型timestamp而数据库中的数据是另一种类型并且含有不能被解释为timestamp的值。 |
-211 (ECPG_CONVERT_BOOL) |
SQLSTATE 42804 |
宿主变量是类型bool而数据库中的数据既不是't'也不是'f'。 |
-212 (ECPG_EMPTY) |
SQLSTATE YE000 |
发送给SQL服务器的语句是空的（通常在一个嵌入式SQL程序中不会发生，因此它可能指向一个内部错误）。 |
-213 (ECPG_MISSING_INDICATOR) |
SQLSTATE 22002 |
返回了一个空值并且没有提供空值指示符。 |
-214 (ECPG_NO_ARRAY) |
SQLSTATE 42804 |
在要求一个数组的地方使用了一个普通变量。 |
-215 (ECPG_DATA_NOT_ARRAY) |
SQLSTATE 42804 |
在一个要求数组值的地方数据库返回了一个普通变量。 |
-216 (ECPG_ARRAY_INSERT) |
SQLSTATE 42804 |
该值不能被插入到数组中。 |
-220 (ECPG_NO_CONN) |
SQLSTATE 08003 |
程序尝试访问一个不存在的连接。 |
-221 (ECPG_NOT_CONN) |
SQLSTATE YE000 |
程序尝试访问一个存在的连接但是它没有打开（这是一个内部错误）。 |
-230 (ECPG_INVALID_STMT) |
SQLSTATE 26000 |
尝试使用的语句还没有被准备好。 |
-239 (ECPG_INFORMIX_DUPLICATE_KEY) |
SQLSTATE 23505 |
重复键错误，违背唯一约束。 |
-240 (ECPG_UNKNOWN_DESCRIPTOR) |
SQLSTATE 33000 |
没有找到指定的描述符，尝试使用的语句还没有被准备好。 |
-241 (ECPG_INVALID_DESCRIPTOR_INDEX) |
SQLSTATE 07009 |
指定的描述符超出范围。 |
-242 (ECPG_UNKNOWN_DESCRIPTOR_ITEM) |
SQLSTATE YE000 |
请求了一个非法的描述符（这是一个内部错误）。 |
-243 (ECPG_VAR_NOT_NUMERIC) |
SQLSTATE 07006 |
在执行一个动态语句期间，数据库返回了一个numeric值而宿主变量不是numeric类型的。 |
-244 (ECPG_VAR_NOT_CHAR) |
SQLSTATE 07006 |
在执行一个动态语句期间，数据库返回了一个非numeric值而宿主变量是numeric类型的。 |
-284 (ECPG_INFORMIX_SUBSELECT_NOT_ONE) |
SQLSTATE 21000 |
子查询的结果不是单一行。 |
-400 (ECPG_PGSQL) |
- |
SQL服务器导致了某个错误。该消息包含来自SQL服务器的错误消息。 |
-401 (ECPG_TRANS) |
SQLSTATE 08007 |
SQL服务器通知我们不能启动、提交或回滚事务。 |
-402 (ECPG_CONNECT) |
SQLSTATE 08001 |
无法建立数据库连接。 |
-403 (ECPG_DUPLICATE_KEY) |
SQLSTATE 23505 |
重复键错误，违背唯一约束。 |
-404 (ECPG_SUBSELECT_NOT_ONE) |
SQLSTATE 21000 |
子查询的结果不是单一行。 |
-602 (ECPG_WARNING_UNKNOWN_PORTAL) |
SQLSTATE 34000 |
指定了一个非法的游标名。 |
-603 (ECPG_WARNING_IN_TRANSACTION) |
SQLSTATE 25001 |
事务正在进行。 |
-604 (ECPG_WARNING_NO_TRANSACTION) |
SQLSTATE 25P01 |
没有活动（正在进行）的事务。 |
-605 (ECPG_WARNING_PORTAL_EXISTS) |
SQLSTATE 42P03 |
指定了一个现有的游标名。 |
- ecpg为嵌入式SQL新增加的SQLSTATE码有：22002，07001，07002，07006，07009，33000，42601，42804，42P03，YE000，YE001。其余SQLSTATE码沿用内核SQLSTATE码。
- SQLSCODE为-400表示ecpg检测到内核服务器返回错误，其SQLSTATE为内核相应错误的SQLSTATE。
