FETCH
FETCH — получить результат запроса через курсор
Синтаксис
FETCH [направление
] [ FROM | IN ]имя_курсора
Здесь допускаетсянаправление
: NEXT PRIOR FIRST LAST ABSOLUTEчисло
RELATIVEчисло
число
ALL FORWARD FORWARDчисло
FORWARD ALL BACKWARD BACKWARDчисло
BACKWARD ALL
Описание
FETCH
получает строки через ранее созданный курсор.
Курсор связан с определённым положением, что и использует команда FETCH
. Курсор может располагаться перед первой строкой результата запроса, на любой строке этого результата, либо после последней строки. При создании курсор оказывается перед первой строкой. Когда FETCH
доходит до конца набора строк, курсор остаётся в положении после последней строки, либо перед первой, при движении назад. После команд FETCH ALL
и FETCH BACKWARD ALL
курсор всегда оказывается после последней строки или перед первой, соответственно.
Формы NEXT
, PRIOR
, FIRST
, LAST
, ABSOLUTE
и RELATIVE
выбирают одну строку после соответствущего перемещения курсора. Если в этом положении строки не оказывается, возвращается пустой результат, а курсор остаётся в достигнутом положении перед первой строкой или после последней.
Формы FORWARD
и BACKWARD
получают указанное число строк, сдвигаясь соответственно вперёд или назад; в результате курсор оказывается на последней выданной строке (или перед/после всех строк, если число
превышает количество доступных строк).
Формы RELATIVE 0
, FORWARD 0
и BACKWARD 0
действуют одинаково — они считывают текущую строку, не перемещая курсор, то есть, повторно выбирая строку, выбранную последней. Эта операция будет успешна, только если курсор не расположен до первой или после последней строки; в этом случае строка возвращена не будет.
Примечание
На этой странице описывается применение курсоров на уровне команд SQL. Если вы попытаетесь использовать курсоры внутри функции PL/pgSQL, правила будут другими — см. Подраздел 43.7.3.
Параметры
направление
Параметр
направление
задаёт направление движения и число выбираемых строк. Он может принимать одно из следующих значений:NEXT
Выбрать следующую строку. Это действие подразумевается по умолчанию, если
направление
опущено.PRIOR
Выбрать предыдущую строку.
FIRST
Выбрать первую строку запроса (аналогично указанию
ABSOLUTE 1
).LAST
Выбрать последнюю строку запроса (аналогично
ABSOLUTE -1
).ABSOLUTE
число
Выбрать строку под номером
число
с начала, либо под номеромabs(
с конца, есличисло
)число
отрицательно. Есличисло
выходит за границы набора строк, курсор размещается перед первой или после последней строки; в частности, сABSOLUTE 0
курсор оказывается перед первой строкой.RELATIVE
число
Выбрать строку под номером
число
, считая со следующей вперёд, либо под номеромabs(
, считая с предыдущей назад, есличисло
)число
отрицательно.RELATIVE 0
повторно считывает текущую строку, если таковая имеется.число
Выбрать следующее
число
строк (аналогичноFORWARD
).число
ALL
Выбрать все оставшиеся строки (аналогично
FORWARD ALL
).FORWARD
Выбрать следующую строку (аналогично
NEXT
).FORWARD
число
Выбрать следующее
число
строк.FORWARD 0
повторно выбирает текущую строку.FORWARD ALL
Выбрать все оставшиеся строки.
BACKWARD
Выбрать предыдущую строку (аналогично
PRIOR
).BACKWARD
число
Выбрать предыдущее
число
строк (с перемещением назад).BACKWARD 0
повторно выбирает текущую строку.BACKWARD ALL
Выбрать все предыдущие строки (с перемещением назад).
число
Здесь
число
— целочисленная константа, возможно со знаком, определяющая смещение или количество выбираемых строк. Для вариантовFORWARD
иBACKWARD
указание отрицательногочисла
равнозначно смене направленияFORWARD
наBACKWARD
и наоборот.имя_курсора
Имя открытого курсора.
Выводимая информация
При успешном выполнении FETCH
возвращает метку команды вида
FETCH число
Здесь count
— количество выбранных строк (может быть и нулевым). Заметьте, что в psql метка команды не выдаётся, так как вместо неё psql выводит выбранные строки.
Примечания
Если перемещение курсора в FETCH
не ограничивается вариантами FETCH NEXT
или FETCH FORWARD
с положительным числом, курсор должен быть объявлен с указанием SCROLL
. Для простых запросов PostgreSQL допускает обратное перемещение курсора, объявленного без SCROLL
, но на это поведение лучше не рассчитывать. Если курсор объявлен с указанием NO SCROLL
, перемещение назад запрещается.
Вариант ABSOLUTE
нисколько не быстрее, чем перемещение к требуемой строке с относительным сдвигом: нижележащий механизм всё равно должен прочитать все промежуточные строки. Выборки по абсолютному отрицательному положению ещё хуже: сначала запрос необходимо прочитать до конца и найти последнюю строку, а затем вернуться назад к указанной строке. Однако перемотка к началу запроса (FETCH ABSOLUTE 0
) выполняется быстро.
Определить курсор позволяет команда DECLARE
, а переместить его, не читая данные, — команда MOVE
.
Примеры
Следующий пример демонстрирует перемещение курсора в таблице:
BEGIN WORK; -- Создание курсора: DECLARE liahona SCROLL CURSOR FOR SELECT * FROM films; -- Получение первых 5 строк через курсор liahona: FETCH FORWARD 5 FROM liahona; code | title | did | date_prod | kind | len -------+-------------------------+-----+------------+----------+------- BL101 | The Third Man | 101 | 1949-12-23 | Drama | 01:44 BL102 | The African Queen | 101 | 1951-08-11 | Romantic | 01:43 JL201 | Une Femme est une Femme | 102 | 1961-03-12 | Romantic | 01:25 P_301 | Vertigo | 103 | 1958-11-14 | Action | 02:08 P_302 | Becket | 103 | 1964-02-03 | Drama | 02:28 -- Получение предыдущей строки: FETCH PRIOR FROM liahona; code | title | did | date_prod | kind | len -------+---------+-----+------------+--------+------- P_301 | Vertigo | 103 | 1958-11-14 | Action | 02:08 -- Закрытие курсора и завершение транзакции: CLOSE liahona; COMMIT WORK;
Совместимость
В стандарте SQL команда FETCH
определена только для встраиваемого SQL. Описанная здесь реализация FETCH
возвращает данные подобно оператору SELECT
, а не помещает их в переменные исполняющей среды. В остальном, FETCH
полностью прямо-совместима со стандартом SQL.
Формы FETCH
с FORWARD
и BACKWARD
, а также формы FETCH
и число
FETCH ALL
(в которых FORWARD
подразумевается) являются расширениями PostgreSQL.
В стандарте SQL перед именем курсора допускается только указание FROM
; возможность указать IN
или опустить оба указания относится к расширениям.