Описание

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

Параметры

Ключевые слова ASENSITIVE, BINARY, INSENSITIVE и SCROLL могут появляться в любом порядке.

Примечания

Обычные курсоры возвращают данные в текстовом формате, таком же, какой выдала бы команда SELECT. Параметр BINARY указывает, что курсор должен возвращать данные в двоичном формате. Это уменьшает усилия по преобразованию как на сервере, так и на клиенте, ценой больших усилий программиста по работе с зависящими от платформы двоичными форматами данных. Например, если запрос возвращает значение единицы из целочисленного столбца, при использовании курсора по умолчанию вы получите строку 1, тогда как с двоичным курсором вы получите 4-байтовое поле, содержащее внутреннее представление значения (в порядке байтов big-endian).

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

Если не указан WITH HOLD, курсор, созданный этой командой, может использоваться только в текущей транзакции. Таким образом, DECLARE без WITH HOLD бесполезен вне блока транзакции: курсор будет существовать только до завершения оператора. Поэтому Digital Q.DataBase сообщает об ошибке, если такая команда используется вне блока транзакции. Используйте команды BEGIN и COMMIT (или ROLLBACK) для определения блока транзакции.

Если указан WITH HOLD и транзакция, создавшая курсор, успешно фиксируется, курсор может продолжать использоваться последующими транзакциями в том же сеансе. (Но если создающая транзакция прерывается, курсор удаляется.) Курсор, созданный с WITH HOLD, закрывается, когда на нём выполняется явная команда CLOSE или когда сеанс завершается. В текущей реализации строки, представленные удерживаемым курсором, копируются во временный файл или область памяти, чтобы они оставались доступными для последующих транзакций.

WITH HOLD не может быть указан, когда запрос включает FOR UPDATE или FOR SHARE.

Параметр SCROLL должен быть указан при определении курсора, который будет использоваться для выборки в обратном направлении. Это требуется стандартом SQL. Однако для совместимости с более ранними версиями Digital Q.DataBase позволяет обратную выборку без SCROLL, если план запроса курсора достаточно прост, чтобы не требовались дополнительные накладные расходы для поддержки этого. Однако разработчикам приложений рекомендуется не полагаться на обратную выборку из курсора, который не был создан с SCROLL. Если указан NO SCROLL, то обратная выборка запрещена в любом случае.

Обратная выборка также запрещена, когда запрос включает FOR UPDATE или FOR SHARE; поэтому в этом случае не может быть указан SCROLL.

Если запрос курсора включает FOR UPDATE или FOR SHARE, то возвращаемые строки блокируются в момент их первого извлечения, так же как для обычной команды SELECT с этими параметрами. Кроме того, возвращаемые строки будут самыми актуальными версиями.

Стандарт SQL предусматривает курсоры только во встроенном SQL. Сервер Digital Q.DataBase не реализует оператор OPEN для курсоров; курсор считается открытым, когда он объявлен. Однако ECPG, препроцессор встроенного SQL для Digital Q.DataBase, поддерживает стандартные соглашения SQL о курсорах, включая те, которые связаны с операторами DECLARE и OPEN.

Базовая структура данных сервера для открытого курсора называется порталом. Имена порталов раскрываются в клиентском протоколе: клиент может извлекать строки напрямую из открытого портала, если знает имя портала. При создании курсора с помощью DECLARE имя портала совпадает с именем курсора.

Все доступные курсоры можно увидеть, запросив системное представление pg_cursors.

Примеры

Чтобы объявить курсор:

DECLARE liahona CURSOR FOR SELECT * FROM films;

Другие примеры использования курсоров см. в FETCH.

Совместимость

Стандарт SQL допускает курсоры только во встроенном SQL и в модулях. Digital Q.DataBase позволяет использовать курсоры в интерактивном режиме.

Согласно стандарту SQL, изменения, внесённые в нечувствительные курсоры с помощью операторов UPDATE ... WHERE CURRENT OF и DELETE ... WHERE CURRENT OF, видны в том же самом курсоре. Digital Q.DataBase обрабатывает эти операторы так же, как все другие операторы, изменяющие данные, в том смысле, что они не видны в нечувствительных курсорах.

Двоичные курсоры являются расширением Digital Q.DataBase.

См. также