Функции
📖 Описание
Функция — подпрограмма PL/SQL, возвращающая значение оператором RETURN.
📌 СОЗДАТЬ ФУНКЦИЮ (CREATE FUNCTION)
Как и на других языках программирования, вы можете создавать свои собственные функции в Oracle.
🧩 Синтаксис:
CREATE [OR REPLACE] FUNCTION имя_функции
[ (параметр [, параметр, ...]) ]
RETURN тип_данных {IS | AS}
[локальные объявления]
BEGIN
исполняемые предложения
[EXCEPTION
обработчики исключений]
END [имя_функции];
Режим IN передаёт входное значение; OUT возвращает значение вызывающему коду; IN OUT передаёт начальное значение и возвращает изменённое. По умолчанию используется IN.
Фигурные и квадратные скобки в шаблоне показывают выбор и необязательные части; в выполняемом коде ниже их нет. Для вызова функции из SQL используйте параметры IN и допустимый SQL-тип результата.
💻 Подготовка
Сохраним сценарий поиска числового кода по названию через явный курсор. Учебная схема имеет CREATE TABLE, CREATE PROCEDURE и квоту:
CREATE TABLE demo_fn_workshops (
workshop_code NUMBER PRIMARY KEY,
workshop_name VARCHAR2(60 CHAR) NOT NULL UNIQUE
);
INSERT INTO demo_fn_workshops VALUES (851, 'Clay Lantern');
INSERT INTO demo_fn_workshops VALUES (852, 'Paper Mosaic');
COMMIT;
Название уникально, поэтому один FETCH даёт определённый результат. Код 0 в этом опыте — маркер отсутствия, а не существующий ключ каталога.
💻 Создание функции
CREATE OR REPLACE FUNCTION demo_find_workshop (
p_workshop_name IN VARCHAR2
) RETURN NUMBER IS
l_code demo_fn_workshops.workshop_code%TYPE;
CURSOR c_workshop IS
SELECT workshop_code
FROM demo_fn_workshops
WHERE workshop_name = p_workshop_name;
BEGIN
OPEN c_workshop;
FETCH c_workshop INTO l_code;
IF c_workshop%NOTFOUND THEN
l_code := 0;
END IF;
CLOSE c_workshop;
RETURN l_code;
END demo_find_workshop;
/
Для Clay Lantern результат 851; для неизвестного названия — 0. NULL также не совпадает ни с одним названием и даёт 0. %NOTFOUND обрабатывает отсутствие строки после FETCH. Неожиданные ошибки передаются вызывающему коду.
💻 Вызов из SQL
Запрос использует собственный список заявок через WITH; отдельная таблица заявок не требуется:
WITH requests (workshop_name, material, event_day) AS (
SELECT 'Clay Lantern', 'CLAY', DATE '2026-12-05' FROM dual
UNION ALL SELECT 'Glass Bead', 'GLASS', DATE '2026-12-12' FROM dual
UNION ALL SELECT 'Paper Mosaic', 'PAPER', DATE '2026-12-19' FROM dual
)
SELECT workshop_name, demo_find_workshop(workshop_name) AS workshop_code,
TO_CHAR(event_day, 'YYYY-MM-DD') AS event_day
FROM requests
WHERE material IN ('CLAY', 'GLASS')
ORDER BY workshop_name;
| WORKSHOP_NAME | WORKSHOP_CODE | EVENT_DAY |
|---|---|---|
| Clay Lantern | 851 | 2026-12-05 |
| Glass Bead | 0 | 2026-12-12 |
Вызов в PL/SQL тоже возможен:
DECLARE
l_code NUMBER;
BEGIN
l_code := demo_find_workshop('Paper Mosaic');
DBMS_OUTPUT.PUT_LINE('workshop_code=' || l_code);
END;
/
-- workshop_code=852
Включите DBMS Output в клиенте; для SQL*Plus/SQLcl — SET SERVEROUTPUT ON. Возвращаемое значение присваивается переменной или используется в выражении. Функция должна выполнить RETURN на каждом нормально завершающемся пути; иначе возникает ошибка отсутствующего результата.
Этот поиск демонстрирует синтаксис. Для большого набора заявок обычный JOIN с каталогом часто удобнее, чем отдельный SQL-запрос внутри функции для каждой строки. Ограничения побочных действий функции, вызываемой из SQL, зависят от контекста; функция примера только читает данные, не выполняет DML или COMMIT.
📌 Проверка компиляции
SELECT line, position, text
FROM user_errors
WHERE name = 'DEMO_FIND_WORKSHOP' AND type = 'FUNCTION'
ORDER BY sequence;
При успешной компиляции ошибок нет. OR REPLACE меняет определение функции и сохраняет ранее выданные объектные права.
📌 DROP FUNCTION
🧩 Синтаксис
DROP FUNCTION function_name;
💻 Пример
DROP FUNCTION demo_find_workshop;
SELECT object_name FROM user_objects
WHERE object_name = 'DEMO_FIND_WORKSHOP' AND object_type = 'FUNCTION';
Проверка не возвращает строк. Таблица каталога сохраняется. DROP FUNCTION удаляет самостоятельную функцию; для функции внутри пакета меняют пакет. CREATE/DROP фиксируют транзакцию и не отменяются обычным ROLLBACK. Подробнее о действиях без возвращаемого выражения: процедуры.