ЛИНТЕР

Привязка динамических параметров

Назначение

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

Синтаксис

Прекомпилятор встроенного SQL распознает и обрабатывает два формата данного предложения:

формат 1 – синтаксис, используемый в предыдущих версиях прекомпилятора и оставленный для совместимости с разработанными приложениями, не рекомендуется для использования в новых проектах;
формат 2 – синтаксис данной версии прекомпилятора.

Формат 1 (устаревший):

<привязка входных параметров>::=
EXEC SQL DESCRIBE BIND VARIABLES FOR <имя предложения>
INTO <имя дескрипторной переменной типа t_sqlda)>;

Формат 2:

<привязка входных параметров>::=
EXEC SQL DESCRIBE INPUT <имя предложения>
{ USING | INTO } SQL DESCRIPTOR <имя дескриптора>;

Формат 1 (устаревший):

<привязка выходных параметров>::=
EXEC SQL DESCRIBE SELECT LIST FOR <имя предложения>
INTO <имя дескрипторной переменной типа t_sqlda >;

Формат 2:

<привязка выходных параметров>::=
EXEC SQL DESCRIBE [ OUTPUT ] <имя предложения>
{ USING | INTO } SQL DESCRIPTOR <имя дескриптора>;

Описание

<Имя предложения> – переменная прекомпилятора, которая должна быть ранее объявлена в DECLARE STATEMENT или использована в операторе PREPARE.
<Имя дескриптора> – переменная встроенного языка, должна быть уникальной или переменной основного языка типа DESCRIPTOR. В этом случае перед именем ставится двоеточие.
Дескриптору <имя дескриптора> необходимо предварительно выделить память (оператор ALLOCATE DESCRIPTOR) для описателей, число которых должно быть не меньше числа динамических параметров в <имени предложения>.
Привязка выходных параметров допустима только для select-запросов и вызова хранимых процедур.
Так как привязка дескриптора выполняется к уже подготовленному предложению, информация о количестве входных и выходных параметров, их типах, длинах, точности представления данных и др. (кроме значений параметров) известна, поэтому при выполнении оператора все сведения автоматически вносятся в дескриптор.
Значения входным параметрам должны присваиваться приложением с помощью оператора SET DESCRIPTOR (или путем явного присвоения значений полям структуры sqlda, соответствующей данному дескриптору, что строго не рекомендуется).
Для select-запросов (для каждого выбираемого значения) в описатель параметра заносятся имя, тип и длина выбираемого значения. Если для выбираемого имени задан псевдоним, в описатель параметра помещается имя псевдонима.
Если предложение является конструкцией UNION c несколькими select-запросами, то в качестве имен параметров используются имена из первого select-запроса.
Для хранимых процедур для каждого параметра процедуры типа OUT, INOUT в описатель параметра заносятся имя, тип и длина выбираемого значения.
Оператор SQL DESCRIBE используется для получения информации о параметрах динамического предложения SQL.
Оператор SET DESCRIPTOR применяется в следующих случаях:
- для привязки переменных основного языка путем задания атрибутов TYPE, LENGTH, DATA основной переменной;
- при заполнении описателей параметров в дескрипторе для еще не подготовленного предложения. В этом случае после подготовки предложения необходимость в операторе SQL DESCRIBE отпадает.