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; } |
| -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 | 宿主变量是类型boolean而数据库中的数据既不是'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。
更多详情请参考GaussDB 文档中心：<https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/productdesc/qlh_03_0001.html>
