SQLCODE
📖 Описание
SQLCODE возвращает числовой код текущего исключения внутри обработчика. Вне обработчика результат равен 0. Для NO_DATA_FOUND возвращается +100; для большинства ошибок Oracle — отрицательный код.
🧩 Синтаксис
SQLCODE
⚙️ Параметры и аргументы
Параметров нет. Для пользовательского исключения без привязанного кода SQLCODE возвращает +1; PRAGMA EXCEPTION_INIT позволяет связать исключение с кодом Oracle.
SQLCODE и SQLERRM вызываются в PL/SQL. Для записи в SQL сначала сохраните их значения в переменные.
💻 Пример
Стоимость делится на нулевое количество участников. Обработчик выводит код −1476 и сообщение о делении на ноль, затем повторно возбуждает исходное исключение:
DECLARE
v_total_fee NUMBER := 180;
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;
/
Связанная функция: SQLERRM.
📌 Сохранение сообщения
Ниже — фрагмент обработчика. Переменные 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 — SQLCODE.
Для просмотра вывода включите DBMS Output в клиенте; в SQL*Plus или SQLcl выполните SET SERVEROUTPUT ON. Строка / запускает завершённый блок в режиме сценария.