35.8. 错误处理

本节介绍如何处理嵌入式 SQL 程序中的异常情况和警告。有两个非排他性的功能。

35 .8.1. 设置回调

捕获错误和警告的一种简单方法是设置在特定情况发生时执行的特定操作。一般来说：

EXEC SQL WHENEVER 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 程序摘录都不会达到预期的效果：

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

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

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

35.8.2. sqlca

为了进行更强大的错误处理，嵌入式 SQL 接口提供了名称为sqlca(SQL 通信区域)的全局变量，该变量具有以下结构：

struct
{
    char sqlcaid[8];
    long sqlabc;
    long sqlcode;
    struct
    {
        int sqlerrml;
        char sqlerrmc[SQLERRMC_LEN];
    } 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，sqlabc，sqlerrp以及sqlerrd和sqlwarn的其余元素当前不包含有用的信息。

sqlca结构未在 SQL 标准中定义，但已在其他几个 SQL 数据库系统中实现。核心上的定义相似，但是如果您要编写可移植的应用程序，则应仔细研究不同的实现。

这是一个结合使用WHENEVER和sqlca并在发生错误时打印sqlca内容的示例。在安装更“用户友好”的错误处理程序之前，这可能对调试或制作应用程序原型很有用。

EXEC SQL WHENEVER SQLERROR CALL print_sqlca();

void
print_sqlca()
{
    fprintf(stderr, "==== sqlca ====\n");
    fprintf(stderr, "sqlcode: %ld\n", sqlca.sqlcode);
    fprintf(stderr, "sqlerrm.sqlerrml: %d\n", sqlca.sqlerrm.sqlerrml);
    fprintf(stderr, "sqlerrm.sqlerrmc: %s\n", sqlca.sqlerrm.sqlerrmc);
    fprintf(stderr, "sqlerrd: %ld %ld %ld %ld %ld %ld\n", sqlca.sqlerrd[0],sqlca.sqlerrd[1],sqlca.sqlerrd[2],
                                                          sqlca.sqlerrd[3],sqlca.sqlerrd[4],sqlca.sqlerrd[5]);
    fprintf(stderr, "sqlwarn: %d %d %d %d %d %d %d %d\n", sqlca.sqlwarn[0], sqlca.sqlwarn[1], sqlca.sqlwarn[2],
                                                          sqlca.sqlwarn[3], sqlca.sqlwarn[4], sqlca.sqlwarn[5],
                                                          sqlca.sqlwarn[6], sqlca.sqlwarn[7]);
    fprintf(stderr, "sqlstate: %5s\n", sqlca.sqlstate);
    fprintf(stderr, "===============\n");
}

结果可能如下所示(此处是由于表名拼写错误而导致的错误)：

==== sqlca ====
sqlcode: -400
sqlerrm.sqlerrml: 49
sqlerrm.sqlerrmc: relation "pg_databasep" does not exist on line 38
sqlerrd: 0 0 0 0 0 0
sqlwarn: 0 0 0 0 0 0 0 0
sqlstate: 42P01
===============

35 .8.3. SQLSTATE 与 SQLCODE

字段sqlca.sqlstate和sqlca.sqlcode是提供错误代码的两种不同方案。两者均源自 SQL 标准，但是SQLCODE已在该标准的 SQL-92 版本中标记为已弃用，并已在以后的版本中删除。因此，强烈建议新应用程序使用SQLSTATE。

SQLSTATE是一个五个字符的数组。这五个字符包含数字或大写字母，代表各种错误和警告条件的代码。 SQLSTATE具有分层方案：前两个字符指示条件的一般类别，后三个字符指示一般条件的子类别。代码00000表示成功状态。 SQLSTATE代码大部分是在 SQL 标准中定义的。 PostgreSQL 服务器本身支持SQLSTATE错误代码。因此，通过在所有应用程序中使用此错误代码方案，可以实现高度的一致性。有关更多信息，请参见Appendix A。

SQLCODE(不建议使用的错误代码方案)是一个简单的整数。值 0 表示成功，正值表示带有附加信息的成功，负值表示错误。 SQL 标准仅定义了正值 100，这表示最后一个命令返回或影响了零行，并且没有特定的负值。因此，该方案只能实现较差的可移植性，并且没有分层代码分配。从历史上看，用于 PostgreSQL 的嵌入式 SQL 处理器已为其分配了一些特定的SQLCODE值，这些值在下面随其数值和符号名称一起列出。请记住，它们不能移植到其他 SQL 实现中。为了简化应用程序到SQLSTATE方案的移植，还列出了相应的SQLSTATE。但是，这两种方案之间没有一对一或一对多的 Map(实际上是多对多的)，因此在每种情况下，都应查阅Appendix A中的全局SQLSTATE列表。

这些是分配的SQLCODE值：

在循环中处理游标时，您可以使用以下代码作为检测何时终止循环的方法，如下所示：

while (1)
{
    EXEC SQL FETCH ... ;
    if (sqlca.sqlcode == ECPG_NOT_FOUND)
        break;
}

但是WHENEVER NOT FOUND DO BREAK在内部有效地执行了此操作，因此，明确地将其写出通常没有任何好处。

上一章 首页 下一章