30.9. 错误处理

30.9.1. 设置回调

捕获错误和警告的一个简单的办法是设置一个特定的动作， 当特定情况发生的时候执行这个动作。通常：

EXEC SQL WHENEVER condition action;

condition 可以是下列之一：

action 可以是下列之一：

SQL 标准只提供 CONTINUE 和 GOTO （也是 GO TO）动作。

下面是一个例子，你可能可以用在简单的程序里。它在发生警告的时候打印一个简单的信息，在发生错误的时候退出程序。

EXEC SQL WHENEVER SQLWARNING SQLPRINT;
EXEC SQL WHENEVER SQLERROR STOP;

语句 EXEC SQL WHENEVER 是 SQL 预处理器的一个指示器， 而不是一个 C 语句。它设置的错误或者警告动作适用于下面出现的设置了句柄的所有 SQL 语句， 除非在第一个 EXEC SQL WHENEVER 和导致条件触发的 SQL 语句之间为同一个条件设置了另外一个动作， 而不管 C 程序内部的流程控制是怎样的。所以，下面的两个 C 程序节选都不会有它们期望的效果。

/*
 * 错误
 */
int main(int argc, char *argv[])
{
    ...
    if (verbose) {
        EXEC SQL WHENEVER SQLWARNING SQLPRINT;
    }
    ...
    EXEC SQL SELECT ...;
    ...
}

/*
 * 错误
 */
int main(int argc, char *argv[])
{
    ...
    set_error_handler();
    ...
    EXEC SQL SELECT ...;
    ...
}

static void set_error_handler(void)
{
    EXEC SQL WHENEVER SQLERROR STOP;
}

30.9.2. sqlca

如果需要更强大的错误处理机制，那么嵌入的 SQL 接口提供了一个叫 sqlca 的全局变量，它是一个有着下面定义的结构：

struct
{
    char sqlcaid[8];
    long sqlabc;
    long sqlcode;
    struct
    {
        int sqlerrml;
        char sqlerrmc[70];
    } sqlerrm;
    char sqlerrp[8];
    long sqlerrd[6];
    char sqlwarn[8];
    char sqlstate[5];
} sqlca;

（在一个多线程的程序里，每个线程自动获得自己的 sqlca 的拷贝。这个方式类似于处理标准 C 全局变量 errno。）

sqlca 包含警告和错误。如果在一个语句的执行中出现多个警告或者错误，那么 sqlca 将只包含最后一个的信息。

如果在最后的 SQL 语句执行过程中没有发生错误， 那么 sqlca.sqlcode 将是 0 并且 sqlca.sqlstate 将是"00000"。如果发生一个警告或者错误， 那么 sqlca.sqlcode 将是负数并且 sqlca.sqlstate 将不是 "00000"。一个正数的 sqlca.sqlcode 标识一种无害的条件，比如最后的查询返回零行。sqlcode 和 sqlstate 是两个不同的错误模式；下面详细介绍。

如果最后一条 SQL 语句成功，如果适合该具体命令，那么 sqlca.sqlerrd[1] 包含处理过的行的 OID，而 sqlca.sqlerrd[2] 包含 处理或返回的行数。

在发生错误或者警告的情况下，sqlca.sqlerrm.sqlerrmc 将包含一个描述该错误的字串。字段 sqlca.sqlerrm.sqlerrml 包含存储在 sqlca.sqlerrm.sqlerrmc 里的错误信息的长度（strlen() 的结果， 对 C 程序员来说并非真正关心的）。请注意有些信息太长，因而不能存储在定长的 sqlerrmc 数组里；它们会被截断。

在发出警告的情况下，sqlca.sqlwarn[2] 被设置为 W。 （在所有其它的情况下，它都被设置为与 W 不同的东西。）如果sqlca.sqlwarn[1] 设置为 W，那么就是一个数值在存储到宿主变量的时候被截断。 如果任何其它元素设置成表示一个警告，那么 sqlca.sqlwarn[0] 被设置为 W。

字段 sqlcaid，sqlcabc， sqlerrp 和剩下的 sqlerrd 以及 sqlwarn 元素目前没有包含有用的信息。

结构 sqlca 没有在 SQL 标准里定义，但是在好几个其它 SQL 数据库系统里定义了。 定义的核心都类似，但是如果你想写可以移植的应用，那么你应该仔细研究不同的实现。

30.9.3. SQLSTATE 与 SQLCODE 之比较

字段 sqlca.sqlstate 和 sqlca.sqlcode 是提供错误代码的两种不同的模式。两种源自 SQL，但是 SQLCODE 在 1992 年的标准版本里标注为废弃的， 并且在 1999 年版本里被删除了。因此，对于新应用，我们强烈建议使用 SQLSTATE。

SQLSTATE 是一个五字符的数组。五个字符包含数值或者大写字母， 代表各种错误或者警告条件的代码。SQLSTATE 有个层次化的模式：头两个字符标识条件的通常表示错误条件的类别， 后三个字符表示在该通用类中的子类。成功的状态是由 00000 标识的。SQLSTATE 代码在大多数地方都是定义在 SQL 标准里的。PostgreSQL 服务器本机支持 SQLSTATE 错误代码；因此在应用里使用这个错误代码模式可以实现非常高的一致性。更多信息请参阅 Appendix A。

SQLCODE 是废弃的错误代码模式，是一个简单的整数。 0 标识成功，正数标识带着额外信息的成功，负数表示一个错误。SQL 标准只定义了正数值 +100， 这个表示最后的命令返回零行或者影响了零行，并且没有特定的负数值。 因此，这个模式只能实现很有限的一致性并且并没有一个层次化的代码机制。 历史上，PostgreSQL 的嵌入的 SQL 处理器为自己使用赋予了一些 SQLCODE 的数值，这些都在下面列出，包括他们的数值和符号名。记住这些是不能移植到其它 SQL 实现中去的。 为了简化应用向 SQLSTATE 模式的移植，我们还列出了 SQLSTATE。 不过，这两个模式之间没有一对一或者一对多的映射（包括多对多），所以在任何情况下你都应该参考在 Appendix A 里列出的全局SQLSTATE。

这些是已经赋值的 SQLCODE 数值：