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