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, правила будут другими — см. Подраздел 42.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. Для простых запросов Postgres Pro допускает обратное перемещение курсора, объявленного без 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 подразумевается) являются расширениями Postgres Pro.
В стандарте SQL перед именем курсора допускается только указание FROM; возможность указать IN или опустить оба указания относится к расширениям.
6.2. Updating Data
The modification of data that is already in the database is referred to as updating. You can update individual rows, all the rows in a table, or a subset of all rows. Each column can be updated separately; the other columns are not affected.
To update existing rows, use the UPDATE command. This requires three pieces of information:
The name of the table and column to update
The new value of the column
Which row(s) to update
Recall from Chapter 5 that SQL does not, in general, provide a unique identifier for rows. Therefore it is not always possible to directly specify which row to update. Instead, you specify which conditions a row must meet in order to be updated. Only if you have a primary key in the table (independent of whether you declared it or not) can you reliably address individual rows by choosing a condition that matches the primary key. Graphical database access tools rely on this fact to allow you to update rows individually.
For example, this command updates all products that have a price of 5 to have a price of 10:
UPDATE products SET price = 10 WHERE price = 5;
This might cause zero, one, or many rows to be updated. It is not an error to attempt an update that does not match any rows.
Let's look at that command in detail. First is the key word UPDATE followed by the table name. As usual, the table name can be schema-qualified, otherwise it is looked up in the path. Next is the key word SET followed by the column name, an equal sign, and the new column value. The new column value can be any scalar expression, not just a constant. For example, if you want to raise the price of all products by 10% you could use:
UPDATE products SET price = price * 1.10;
As you see, the expression for the new value can refer to the existing value(s) in the row. We also left out the WHERE clause. If it is omitted, it means that all rows in the table are updated. If it is present, only those rows that match the WHERE condition are updated. Note that the equals sign in the SET clause is an assignment while the one in the WHERE clause is a comparison, but this does not create any ambiguity. Of course, the WHERE condition does not have to be an equality test. Many other operators are available (see Chapter 9). But the expression needs to evaluate to a Boolean result.
You can update more than one column in an UPDATE command by listing more than one assignment in the SET clause. For example:
UPDATE mytable SET a = 5, b = 3, c = 1 WHERE a > 0;