捕获错误和警告的一种简单方法是指定一个动作，在特定条件发生时执行。一般形式如下：

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;
}

为了支持更强大的错误处理，嵌入式 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 的其余元素，目前不包含有用信息。

SQL 标准中没有定义 sqlca 结构体，但是在一些其他的 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
===============

字段 sqlca.sqlstate 和 sqlca.sqlcode 采用两种不同的错误编码方案。两者都源自 SQL 标准，但 SQLCODE 在 SQL-92 标准中已被标记为弃用，并在后续版本中被删除。因此，强烈建议新应用使用 SQLSTATE。

SQLSTATE 是一个包含五个字符的数组。这五个字符由数字或大写字母组成，表示各种错误和警告条件的代码。SQLSTATE 采用分层编码方案：前两个字符表示条件所属的大类，后三个字符表示该大类中的子类。代码 00000 表示成功状态。大部分 SQLSTATE 代码由 SQL 标准定义。PostgreSQL 服务器原生支持 SQLSTATE 错误码，因此在所有应用中统一使用这种错误编码方案，可以实现较高的一致性。更多信息见附录 A。

已弃用的错误编码方案 SQLCODE 使用一个简单的整数。0 表示成功，正值表示成功并有附加信息，负值表示错误。SQL 标准只定义了正值 +100，表示上一个命令返回或影响了零行，没有定义具体的负值。因此，这种方案的可移植性较差，也不采用分层编码。历史上，PostgreSQL 的嵌入式 SQL 处理器为自身使用分配了一些特定的 SQLCODE 值，下文列出了它们的数值和符号名称。注意，这些值不能移植到其他 SQL 实现。为了便于将应用迁移到 SQLSTATE 方案，还列出了对应的 SQLSTATE。不过，两种方案之间不存在一对一或一对多的映射关系（实际上是多对多），因此每次都应查阅附录 A 中的完整 SQLSTATE 列表。

以下是已分配的 SQLCODE 值：