Встроенные исключения
📖 Описание
Предопределённые исключения имеют имена в пакете STANDARD. Их можно сразу указывать в WHEN. Не переобъявляйте эти имена локально: новое объявление скроет стандартное исключение. Ниже перечислены предопределённые исключения Oracle Database 19c.
| Исключение | Ошибка Oracle | Когда возникает |
|---|---|---|
| DUP_VAL_ON_INDEX | ORA-00001 | Нарушена уникальность первичного ключа или уникального ограничения/индекса, в том числе составного. |
| TIMEOUT_ON_RESOURCE | ORA-00051 | Истёк срок ожидания ресурса. |
| INVALID_CURSOR | ORA-01001 | Недопустимая операция с курсором, например FETCH закрытого курсора. |
| NOT_LOGGED_ON | ORA-01012 | Вызов требует соединения с Oracle, но сеанс не подключён. |
| LOGIN_DENIED | ORA-01017 | Отклонена аутентификация при подключении. |
| NO_DATA_FOUND | ORA-01403; SQLCODE = +100 | SELECT INTO без BULK COLLECT не вернул строк; также чтение отсутствующего элемента ассоциативного массива или конец файла при чтении UTL_FILE. |
| TOO_MANY_ROWS | ORA-01422 | SELECT INTO без BULK COLLECT вернул больше одной строки. |
| ZERO_DIVIDE | ORA-01476 | Деление на ноль. |
| INVALID_NUMBER | ORA-01722 | В SQL не удалось преобразовать строку в число. Само допустимое преобразование ошибкой не является. |
| STORAGE_ERROR | ORA-06500 | Нехватка или повреждение памяти PL/SQL. |
| PROGRAM_ERROR | ORA-06501 | Внутренняя ошибка PL/SQL. |
| VALUE_ERROR | ORA-06502 | Ошибка значения, размера, преобразования или ограничения в PL/SQL. |
| CURSOR_ALREADY_OPEN | ORA-06511 | Повторное OPEN уже открытого курсора. |
| ACCESS_INTO_NULL | ORA-06530 | Обращение для присваивания к атрибуту неинициализированного объекта. |
| CASE_NOT_FOUND | ORA-06592 | Оператор CASE не нашёл подходящей ветви и не содержит ELSE. |
| COLLECTION_IS_NULL | ORA-06531 | Недопустимая операция с неинициализированной коллекцией. |
| NO_DATA_NEEDED | ORA-06548 | Конвейерной табличной функции больше не требуется выдавать строки. |
| ROWTYPE_MISMATCH | ORA-06504 | Тип возвращаемой строки курсора не соответствует принимающей структуре. |
| SELF_IS_NULL | ORA-30625 | Вызов метода объекта через NULL SELF. |
| SUBSCRIPT_BEYOND_COUNT | ORA-06533 | Обращение за пределы созданных позиций коллекции. |
| SUBSCRIPT_OUTSIDE_LIMIT | ORA-06532 | Индекс вне допустимого диапазона типа коллекции. |
| SYS_INVALID_ROWID | ORA-01410 | Недопустимое представление ROWID. |
Для NO_DATA_FOUND функция SQLCODE возвращает положительное 100, хотя сообщение имеет номер ORA-01403. Агрегатный SELECT COUNT(*) без GROUP BY возвращает одну строку со значением 0 даже при пустом входе, поэтому сам по себе не вызывает NO_DATA_FOUND. Завершение FETCH явного курсора проверяют через %NOTFOUND.
🧩 Обработчик в процедуре
Имена стандартных исключений не требуется объявлять. В примере DUP_VAL_ON_INDEX преобразуется в отдельный код приложения; остальные ошибки повторно поднимаются. Сначала создайте таблицу и обе подпрограммы, затем выполняйте учебный DML.
CREATE TABLE demo_exception_mentors (
mentor_id NUMBER PRIMARY KEY,
mentor_name VARCHAR2(40 CHAR) NOT NULL
);
CREATE OR REPLACE PROCEDURE demo_add_mentor(p_id NUMBER, p_name VARCHAR2) IS
BEGIN
INSERT INTO demo_exception_mentors (mentor_id, mentor_name) VALUES (p_id, p_name);
EXCEPTION
WHEN DUP_VAL_ON_INDEX THEN
RAISE_APPLICATION_ERROR(-20071, 'Mentor ID already exists');
WHEN OTHERS THEN
RAISE;
END;
/
🧩 Обработчик в функции
Здесь отсутствие наставника — ожидаемый случай, для которого функция по своему контракту возвращает текст Unknown. Успешный путь также содержит RETURN.
CREATE OR REPLACE FUNCTION demo_mentor_label(p_id NUMBER)
RETURN VARCHAR2 IS
v_name demo_exception_mentors.mentor_name%TYPE;
BEGIN
SELECT mentor_name INTO v_name
FROM demo_exception_mentors WHERE mentor_id = p_id;
RETURN v_name;
EXCEPTION
WHEN NO_DATA_FOUND THEN
RETURN 'Unknown';
END;
/
Неизвестные ошибки здесь передаются наружу автоматически: WHEN OTHERS не обязателен. Первичный ключ гарантирует не более одной строки для SELECT INTO.
💻 Вызов и обработка дубликата
DECLARE
e_duplicate_mentor EXCEPTION;
PRAGMA EXCEPTION_INIT(e_duplicate_mentor, -20071);
BEGIN
SAVEPOINT before_named_demo;
demo_add_mentor(41, 'Aziza');
DBMS_OUTPUT.PUT_LINE(demo_mentor_label(41));
DBMS_OUTPUT.PUT_LINE(demo_mentor_label(99));
BEGIN
demo_add_mentor(41, 'Nodira');
EXCEPTION
WHEN e_duplicate_mentor THEN
DBMS_OUTPUT.PUT_LINE('Duplicate mentor: ' || SQLCODE);
END;
ROLLBACK TO before_named_demo;
EXCEPTION
WHEN OTHERS THEN
ROLLBACK TO before_named_demo;
RAISE;
END;
/
-- Aziza
-- Unknown
-- Duplicate mentor: -20071
Дубликат не заменяет исходное имя Aziza. Откат в конце убирает учебную строку. Процедуры сами не фиксируют транзакцию.
💻 ZERO_DIVIDE и продолжение внешнего блока
DECLARE
v_total NUMBER := 360;
v_guests PLS_INTEGER := 0;
v_fee NUMBER;
BEGIN
BEGIN
v_fee := v_total / v_guests;
EXCEPTION
WHEN ZERO_DIVIDE THEN
v_fee := NULL;
DBMS_OUTPUT.PUT_LINE('No guests: fee is undefined');
END;
DBMS_OUTPUT.PUT_LINE('Outer block continues');
END;
/
-- No guests: fee is undefined
-- Outer block continues
В рабочем расчёте можно заранее проверить v_guests = 0. Здесь деление используется специально для демонстрации перехода в обработчик. Продолжается внешний блок, а не оборванная последовательность внутри ошибочного блока.
См. WHEN OTHERS и пользовательские исключения. Не объявляйте своё исключение с именем ZERO_DIVIDE или другим именем из STANDARD: оно скроет стандартное.
Документация Oracle 19c: predefined-exceptions, exception-handler, EXCEPTION_INIT-pragma, continuing-execution-handling-exceptions. Для просмотра вывода включите DBMS Output в клиенте.