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. Завершающий / отправляет блок на выполнение в этих клиентах.