ЛИНТЕР

Объявление статического курсора

Назначение

Вид курсора и способ объявления курсора зависят от того, каким методом будет формироваться выборка данных: с помощью select-запроса (статический курсор) или с помощью хранимой процедуры, возвращающей в качестве ответа тип данных «курсор» (динамический курсор).

Синтаксис

<объявление статического курсора>::=
EXEC SQL DECLARE <имя курсора>
  [SCROLL | INSENSITIVE ] CURSOR [FOR <предложение>];
<имя курсора>::= <идентификатор> | <строковый литерал>
<предложение>::= <переменная встроенного языка типа «предложение»>
  |<непосредственно предложение SQL>
  | <строковый литерал>
  |<переменная основного языка>

Описание

Конструкция SCROLL | INSENSITIVE введена для совместимости синтаксиса со стандартом SQL93. В данной версии встроенного SQL не обрабатывается. Если такая конструкция задается, появляется предупреждение «Опция не поддерживается».
<Предложение> задает предложение, потенциально возвращающее множественную выборку данных. <Предложение> может быть представлено 3 способами:
- ссылкой на имя предложения (вариант <имя предложения>), содержащего запрос. В этом случае данное предложение должно быть предварительно подготовлено к выполнению с помощью оператора PREPARE, например:
```
EXEC SQL BEGIN DECLARE SECTION;
char*query="SELECT * FROM test WHERE name LIKE :v1 ORDER BY 1");;
EXEC SQL END DECLARE SECTION;
EXEC SQL PREPARE ST FROM :query;
EXEC SQL DECLARE CR CURSOR_PCI FOR ST; /* только декларация курсора Оператор не влечет за собой создания кода */
```
- непосредственно (вариант <предложение SQL> или <строковый литерал>), например:
```
EXEC SQL DECLARE CR CURSOR FOR "select name from person"; /* создаем курсор из предложения SQL, заданного строковым
литералом */
EXEC SQL DECLARE CR CURSOR_PCI FOR select name from person where id>:ident; /* создаем курсор из предложения SQL,
заданного непосредственно и привязываем переменную ident */
```
  В этом случае оператор влечет за собой создание кода после претрансляции.
Примечания
1. В двух последних случаях автоматически выполняется оператор PREPARE для неименованного предложения. Явное выполнение оператора PREPARE нужно в том случае, если SQL-запросу необходимо присвоить имя для возможной ссылки на этот запрос в других операторах программы.
2. В качестве SQL-запроса при объявлении курсора можно задать любой запрос (не обязательно возвращающий множественную выборку данных, например, DROP TABLE). В этом случае запрос будет отработан, и при его нормальном выполнении сформируется код завершения «Нет данных».
Объявленный таким способом курсор может использоваться только для select-запросов.
Со статическим курсором допускается выполнять следующие действия:
- открыть курсор посредством оператора OPEN;
- произвести выборку с помощью оператора FETCH;
- использовать в позиционных SQL-запросах (с конструкцией CURRENT OF …);
- работать с BLOB-данными посредством операторов {ADD | GET | CLEAR} BLOB;
- закрыть курсор с помощью оператора CLOSE.

Объявление статического курсора

Назначение

Синтаксис

Описание

Примечания