Один простой способ обнаружить ошибки и предупреждения - установить определенное действие, которое будет выполняться при возникновении определенного условия. Обычно:

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 не будет иметь желаемого эффекта:

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

Для более мощной обработки ошибок, встроенный SQL-интерфейс предоставляет глобальную переменную с именем sqlca (SQL communication area), которая имеет следующую структуру:

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
===============

Поля sqlca.sqlstate и sqlca.sqlcode представляют собой две разные схемы, предоставляющие коды ошибок. Оба они производные от стандарта SQL, но SQLCODE был помечен как устаревший в стандарте SQL-92 и был удален в последующих версиях. Поэтому новым приложениям настоятельно рекомендуется использовать SQLSTATE.

SQLSTATE - это массив из пяти символов. Пять символов содержат цифры или заглавные буквы, которые представляют коды различных ошибок и предупреждений. SQLSTATE имеет иерархическую схему: первые два символа указывают на общий класс условия, последние три символа указывают на подкласс общего условия. Успешное состояние указывается кодом 00000. Коды SQLSTATE в большинстве своем определены в стандарте SQL. Сервер Tantor BE нативно поддерживает коды ошибок SQLSTATE; поэтому высокая степень согласованности может быть достигнута путем использования этой схемы кодов ошибок во всех приложениях. Дополнительную информацию см. в Предметный указатель A.

SQLCODE, устаревшая схема кодов ошибок, представляет собой простое целое число. Значение 0 указывает на успешное выполнение, положительное значение указывает на успешное выполнение с дополнительной информацией, отрицательное значение указывает на ошибку. Стандарт SQL определяет только положительное значение +100, которое указывает на то, что последняя команда вернула или затронула ноль строк, и не определяет конкретные отрицательные значения. Поэтому эта схема может обеспечить только низкую переносимость и не имеет иерархического присвоения кодов. Исторически, встроенный процессор SQL для Tantor BE назначал некоторые конкретные значения SQLCODE для своего использования, которые перечислены ниже с их числовым значением и символическим именем. Помните, что они не переносимы на другие реализации SQL. Для упрощения переноса приложений на схему SQLSTATE также указан соответствующий SQLSTATE. Однако между двумя схемами нет однозначного или однозначного-многозначного соответствия (на самом деле, это соответствие многозначное), поэтому в каждом случае следует обратиться к общему перечню SQLSTATE в Предметный указатель A.

Это назначенные значения SQLCODE: