Встроенный SQL

Переменные связи

Переменные связи (bind-переменные) служат для передачи значений в СУБД. Эти переменные могут использоваться во фразе WHERE для вычисления условия, в операторах INSERT и DELETE для определения устанавливаемых значений.

Переменные связи, так же как и INTO-переменные, перед применением должны быть предварительно объявлены. Переменные связи при указании их в SQL-операторе предваряются символом "двоеточие".

Например:

EXEC SQL INSERT INTO tbl2 (f1,f2,f3) 
         VALUES (:f1,:f2,:f3);

Курсоры

Под курсором, как правило, понимают получаемый при выполнении запроса результирующий набор и связанный с ним указатель текущей записи. Курсор - это объект, связанный с определенной областью памяти. Существуют явные и неявные курсоры.

Явный курсор имеет имя и перед использованием должен быть объявлен. Неявный курсор создается автоматически и его нельзя повторно открыть без перекомпиляции оператора запроса.

Объявление курсора выполняется оператором DECLARE CURSOR, в котором фраза FOR определяет запрос, ассоциируемый с данным курсором.

Например, оператор

EXEC SQL DECLARE c1 CURSOR FOR 
     SELECT f1,f2,f3 FROM tbl1 WHERE f2>100;

создает курсор c1 на базе таблицы tbl1. При объявлении курсора выполнения запроса не происходит. Выполнение запроса и создание курсора инициируется оператором OPEN CURSOR.

Например, оператор

EXEC SQL OPEN CURSOR с1;

создаст курсор, выполнив определенный в нем оператор SELECT.

Приложение получает доступ к данным курсора при последовательном извлечении строк результирующего набора в переменные приложения.

Для извлечения данных из курсора используется оператор FETCH

Например, оператор

EXEC SQL FETCH c1 INTO :f1,:f2,:f3;

извлекает значения текущей строки курсора в INTO-переменные.

Для освобождения памяти, выделенной под курсор, его следует закрыть, выполнив оператор CLOSE CURSOR.

Например:

EXEC SQL CLOSE CURSOR с1;

Обработка NULL-значений

Для работы с NULL-значениями предусмотрены индикаторные переменные, которые могут использоваться для:

• определения извлекаемого NULL-значения;
• внесения NULL-значения в таблицу;
• фиксирования усекаемых строк.

Если в результате выполнения оператора FETCH или оператора SELECT (возвращающего одну строку) извлекаемые данные принимают значение NULL, то, во-первых, считается, что SQL-оператор выполнен с ошибкой, а во-вторых, в INTO-переменную будет записано значение, отличное от NULL (зависит от типа переменной). Для предотвращения таких ситуаций применяются индикаторные переменные, указываемые после INTO-переменной через символ двоеточия (или INDICATOR:). Если индикаторная переменная принимает отрицательное значение, значит, столбец содержит значение NULL. По умолчанию до выполнения оператора индикаторной переменной присваивается значение 0.

Например:

Если в операторе INSERT или UPDATE требуется указать, что используемая переменная связи может содержать значение NULL, то после этой переменной через двоеточие следует записать индикаторную переменную. В этом случае при отрицательном значении индикаторной переменной в базу данных будет занесено значение NULL.

При фиксировании усекаемых строк в индикаторную переменную записывается первоначальная длина строки, а сама строка записывается в переменную основного языка с усечением.

Позиционированные операторы

Для обновления курсора в операторах DELETE и UPDATE может использоваться фраза WHERE CURRENT OF, определяющая, что действие относится к текущей строке курсора. Такой оператор называется позиционированным , и к нему предъявляются следующие требования:

• и курсор, и оператор должны использовать только одну и ту же таблицу;
• в запросе, используемом для создания курсора, не должно быть фраз UNION и ORDER BY ;
• курсор должен удовлетворять критериям обновляемого курсора (например, не применять агрегирующие функции).

Например:

EXEC SQL DECLARE c1 CURSOR FOR SELECT f1,f2 FROM tbl1;
EXEC SQL OPEN CURSOR c1;
EXEC SQL FETCH c1 INTO :f1,:f2;
EXEC SQL UPDATE tbl1 SET f2=f2*1.3 
         WHERE CURRENT OF c1;

Позиционированный оператор DELETE удобно использовать для удаления из таблицы группы строк, предварительно выбранных в курсор.

Обработка ошибок

Стандартом SQL-92 определено две переменных, которые позволяют получать информацию о выполняемом SQL-операторе:

• переменная SQLSTATE имеет тип char(5) и содержит информацию о классе (два старших символа) и подклассе (3 младших символа), описывающих состояние выполненного SQL-оператора;
• переменная SQLCODE имеет целочисленный тип и содержит код завершения последнего выполненного SQL-оператора.

Как и другие переменные, используемые во встроенном SQL, переменные SQLSTATE и SQLCODE предварительно должны быть объявлены. Однако переменная SQLCODE может быть создана по умолчанию, если нет объявления другой переменной, получающей информацию о завершении выполнения SQL-оператора.

После выполнения SQL-оператора данные о статусе и коде выполнения автоматически записываются СУБД в эти переменные.

Статус выполнения SQL-оператора может быть определен как:

• успешное завершение. Соответствует в SQLSTATE коду '00000' (класс '00' ). SQLCODE в этом случае тоже равна 0;
• успешное завершение с предупреждением. Класс состояния '02' в SQLSTATE определяет предупреждение 'NOT FOUND' ; класс состояния '01' указывает предупреждение, более точно специфицируемое подклассом;
• завершение с ошибкой. Классы '03' и последующие в SQLSTATE описывают различные ошибочные ситуации (подклассы специфицируют как стандартные ситуации, так и определяемые приложением).

Предупреждение 'NOT FOUND' указывает, что SQL-оператор не содержал ошибки, но не вернул ожидаемого результата. Например, сформированный результирующий набор не содержит ни одной строки, или оператор UPDATE не изменил ни одной строки.

Переменные SQLCODE и SQLSTATE очень часто используются в операторе while для завершения цикла и для выхода из него в случае возникновения ошибки.

Встроенный SQL поддерживает оператор WHENEVER, определяющий действия, которые будут выполнены при возникновении описанной ситуации. Этот оператор следует указывать до выполнения того SQL-оператора, чья обработка ошибок будет "перехватываться".

Оператор WHENEVER влияет на все выполняемые SQL-операторы.

Например:

EXEC SQL WHENEVER SQLERROR GOTO Err_1;
EXEC SQL WHENEVER NOT FOUND CONTINUE;
EXEC SQL WHENEVER SQLWARNING CONTINUE;
EXEC SQL OPEN CURSOR c1;
EXEC SQL FETCH c1 INTO :f1,:f2,:f3;
:
err_1: std::cout<<'' SQLERROR'';
:
EXEC SQL CLOSE CURSOR c1;

Оператор WHENEVER определяет или метку, на которую будет выполнен переход при возникновении ошибки, или действие типа CONTINUE (продолжение выполнения), или процедуру обработки ошибок.