SQLERRM

📖 Описание

SQLERRM возвращает сообщение текущего исключения. Необязательный аргумент позволяет получить текст по коду ошибки: SQLERRM(error_code). Без аргумента вне обработчика возвращается сообщение ORA-0000. Язык сообщения зависит от NLS_LANGUAGE.


🧩 Синтаксис

SQLERRM
SQLERRM(error_code)

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

error_code — необязательный числовой код ошибки. Например, SQLERRM(-1476) возвращает сообщение о делении на ноль.

SQLCODE и SQLERRM вызываются в PL/SQL. Для записи в SQL сначала сохраните их значения в переменные.


💻 Пример

Стоимость делится на нулевое количество участников. Обработчик выводит код −1476 и сообщение о делении на ноль, затем повторно возбуждает исходное исключение:

DECLARE
  v_total_fee NUMBER := 90;
  v_count NUMBER := 0;
  v_unit_fee NUMBER;
BEGIN
  v_unit_fee := v_total_fee / v_count;
EXCEPTION
  WHEN OTHERS THEN
    DBMS_OUTPUT.PUT_LINE(SQLCODE || ' — ' || SQLERRM);
    RAISE;
END;
/

Связанная функция: SQLCODE.

📌 Сохранение сообщения

Ниже — фрагмент обработчика. Переменные v_error_code NUMBER и v_error_text VARCHAR2(512), а также таблица demo_booking_errors(error_code, error_text), должны быть объявлены заранее.

EXCEPTION
  WHEN OTHERS THEN
    v_error_code := SQLCODE;
    v_error_text := SQLERRM;
    INSERT INTO demo_booking_errors (error_code, error_text)
    VALUES (v_error_code, v_error_text);
    RAISE;

Обычная запись аудита участвует в текущей транзакции и может быть отменена вместе с ней. RAISE_APPLICATION_ERROR позволяет сформировать собственную ошибку приложения; повторный RAISE сохраняет исходную ошибку.

Справочник: Oracle — SQLERRM.

Для просмотра вывода включите DBMS Output в клиенте; в SQL*Plus или SQLcl выполните SET SERVEROUTPUT ON. Строка / запускает завершённый блок в режиме сценария.