4.6. エラー処理

埋め込み SQL インタフェースには、プログラム内の例外条件を処理するために、単純化された方法と複雑な方法の両方が備わっています。 単純化された方法では、特定の条件が発生する度にメッセージが表示されるようにします。たとえば、以下のようにします。

EXEC SQL WHENEVER sqlerror sqlprint;

または

EXEC SQL WHENEVER not found sqlprint;

このエラー処理方法は、プログラム全体で使用することができます。

埋め込み SQL インタフェースのより強力なエラー処理は、以下に示す struct と変数 sqlca です。

struct sqlca
{
    char sqlcaid[8];
    long sqlabc;
    long sqlcode;
    struct
    {
        int sqlerrml;
        char sqlerrmc[70];
    } sqlerrm;
    char sqlerrp[8];

    long sqlerrd[6];
    /* 0: 空                                            */
    /* 1: 処理されたタプルの OID（あるならば）          */
    /* 2: INSERT、UPDATE、DELTE で処理された行数        */
    /* 3: 空                                            */
    /* 4: 空                                            */
    /* 5: 空                                            */

    char sqlwarn[8];
    /* 0: 少なくともどれかが 'W'ならば'W'               */
    /* 1: 'W' ならば、少なくとも 1 つの文字列がホストの */ 
    /*    変数に保存されるときに切りつめられている      */
    /* 2: 空                                            */
    /* 3: 空                                            */
    /* 4: 空                                            */
    /* 5: 空                                            */
    /* 6: 空                                            */
    /* 7: 空                                            */

    char sqlext[8];
} sqlca;

(空のフィールドの多くは、今後のリリースで使用される可能性があります。)

もし上の SQL 文でエラーが発生しなかった場合、sqlca.sqlcode は 0 (ECPG_NO_ERROR) になります。もしsqlca.sqlcodeが0よりも小さい場合、データベース定義が与えられた問い合わせと合わないといった深刻なエラーです。もし0より大きい場合はテーブルが要求された行を含まないといった通常のエラーです。

sqlca.sqlerrm.sqlerrmc は、エラーを説明する文字列を持っています。 その文字列はソースファイルの行数で終わります。

起こり得るエラーを以下に示します。