Встроенные исключения

📖 Описание

Предопределённые исключения имеют имена в пакете 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 в клиенте.