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

EXEC SQL WHENEVER условие действие;

условие может быть одним из следующих вариантов:

действие может быть одним из следующих вариантов:

Стандарт 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) имеет следующую структуру:

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 array; они будут усечены.

В случае предупреждения параметр 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: отношение "pg_databasep" не существует на строке 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 представляет собой массив из пяти символов типа данных char. Данные пять символов содержат цифры или заглавные буквы, которые представляют коды различных условий ошибок и предупреждений. SQLSTATE имеет иерархическую схему: первые два символа обозначают общий класс состояния, а последние три символа указывают на подкласс общего состояния. Состояние успешного выполнения обозначается кодом 00000. Параметры SQLSTATE в большинстве случаев определены в стандарте SQL. Digital Q.DataBase сервер изначально поддерживает SQLSTATE коды ошибок; следовательно, высокая степень согласованности может быть достигнута путем использования данной схемы кодов ошибок во всех приложениях. Для получения дополнительной информации см. Приложение 8.1.

SQLCODE, устаревшая схема кодов ошибок, представляет собой простое целое число. Значение 0 указывает на успешное выполнение, положительное значение указывает на успех с дополнительной информацией, а отрицательное значение указывает на ошибку. Стандарт SQL определяет только положительное значение +100, которое указывает на то, что последняя команда вернула или обработала ноль строк; конкретные отрицательные значения в стандарте не определены. Следовательно, данная схема обеспечивает лишь слабую переносимость и не обладает иерархической системой назначения кодов. Исторически сложилось так, что процессор внедренного SQL для Digital Q.DataBase назначал определенные специфические SQLCODE значения для внутреннего использования, которые приведены ниже вместе с их значениями типа numeric и символьными именами. Помните, что они не являются переносимыми на другие реализации SQL. Чтобы упростить перенос приложений на SQLSTATE схему, соответствующие параметры SQLSTATE также указаны в списке. Однако между этими двумя схемами нет однозначного или взаимно-однозначного соответствия (на самом деле это отношение «многие ко многим»), поэтому в каждом конкретном случае следует обращаться к глобальному SQLSTATE списку в Приложение 8.1 для уточнения деталей.

Ниже приведены назначенные SQLCODE значения: