CURSOR FOR LOOP

📖 Описание

CURSOR FOR LOOP последовательно обрабатывает строки результата запроса. PL/SQL сам открывает курсор, извлекает очередную строку в запись цикла и закрывает курсор после обработки.


🧩 Синтаксис

FOR record_index IN cursor_name
LOOP
   NULL; -- замените обработкой record_index
END LOOP;

⚙️ Параметры и аргументы

record_index — автоматически объявляемая запись со структурой строки курсора, а не числовой индекс. Обращение к столбцу: record_index.column_name. Запись доступна только внутри цикла.

cursor_name — имя объявленного явного курсора. Перед входом в цикл он не должен быть открыт.

Тело цикла выполняется для каждой извлечённой строки.


📝 Примечание

  • Отдельно писать OPEN, FETCH и CLOSE для такого цикла не требуется.
  • Если запрос не вернул строк, тело цикла не выполнится.
  • Курсор также закрывается при выходе из цикла через EXIT или исключение.

💻 Пример

Функция суммирует сборы мастер-классов заданного вида. Таблица создаётся в учебной схеме:

CREATE TABLE demo_cursor_fees (
  lesson_id NUMBER PRIMARY KEY,
  kind VARCHAR2(20),
  fee NUMBER
);
INSERT INTO demo_cursor_fees VALUES (1, 'CLAY', 80);
INSERT INTO demo_cursor_fees VALUES (2, 'CLAY', NULL);
INSERT INTO demo_cursor_fees VALUES (3, 'CLAY', 125);
INSERT INTO demo_cursor_fees VALUES (4, 'PAPER', 60);

CREATE OR REPLACE FUNCTION demo_total_fee (p_kind IN VARCHAR2)
  RETURN NUMBER
IS
  v_total NUMBER := 0;
  CURSOR c_fees IS
    SELECT fee FROM demo_cursor_fees
    WHERE kind = p_kind;
BEGIN
  FOR fee_rec IN c_fees LOOP
    v_total := v_total + NVL(fee_rec.fee, 0);
  END LOOP;
  RETURN v_total;
END;
/

SELECT demo_total_fee('CLAY') AS clay_total,
       demo_total_fee('WOOD') AS wood_total
FROM dual;
CLAY_TOTAL WOOD_TOTAL
205 0

CLAY даёт 80 + 0 + 125 = 205. Для WOOD строк нет, цикл не входит в тело, v_total остаётся 0. NVL явно трактует неизвестный сбор как ноль — это выбранное правило примера. Функция возвращает NUMBER. Создание таблицы и функции требует соответствующих прав; DDL фиксирует текущую транзакцию.

Запрос непосредственно в цикле

Вместо имени явного курсора можно записать SELECT в скобках. На той же таблице:

BEGIN
  FOR fee_rec IN (
    SELECT kind, SUM(NVL(fee, 0)) AS total_fee
    FROM demo_cursor_fees
    GROUP BY kind
    ORDER BY kind
  ) LOOP
    DBMS_OUTPUT.PUT_LINE(fee_rec.kind || ': ' || fee_rec.total_fee);
  END LOOP;
END;
/
CLAY: 205
PAPER: 60

Вычисленному столбцу присвоен псевдоним total_fee, чтобы к нему можно было обратиться как к полю записи. Запись fee_rec существует только внутри цикла. Для одной суммы без построчной обработки обычно достаточно SUM в SQL.

Для просмотра строк включите DBMS Output в клиенте; в SQL*Plus или SQLcl перед блоком можно выполнить SET SERVEROUTPUT ON. Завершающий / отправляет блок на выполнение в этих клиентах.

См. документацию Oracle PL/SQL: cursor-FOR-LOOP-statement.