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 程序員來說並非 真正關心的）。

在發出警告的情況下，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 數值：