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. Строка / запускает завершённый блок в режиме сценария.