PL/SQL блок:
DECLARE
… — объявляющая секция
BEGIN
… — выполняющая секция
EXCEPTION
… — секция обработки исключительных ситуаций
END;
/
При установлении исключительной ситуации управление программой сразу же передается
в секцию исключительных ситуаций блока.
Если такой секции в блоке нет, то исключение передается в объемлющий блок.
После передачи управления обработчику, вернуться в выполняющую секцию блока невозможно.
Исключения бывают:
— стандартные
— определенные пользователем
Стандартные исключительные ситуации инициируются автоматически при возникновении
соответствующей ошибки Oracle.
Исключительные ситуации, определяемые пользователем,
устанавливаются явно при помощи оператора RAISE.
Обрабатываются исключения так:
EXCEPTION
WHEN имя_ex1 THEN
…; — обработать
WHEN имя_ex2 THEN
…; — обработать
WHEN OTHERS THEN
…; — обработать
END;
/
Имена исключений не должны повторяться т.е. каждое исключение может
обрабатываться максимум только одним обработчиком в секции EXCEPTION
Один обработчик может обслуживать несколько исключительных ситуаций
и их нужно перечислить в условии WHEN через OR
EXCEPTION
WHEN NO_DATA_FOUND OR TOO_MANY_ROWS THEN
INSERT INTO log_table(info) VALUES (‘A select error occurred.’);
END;
/
Два исключения одновременно один обработчик обработать не может:
WHEN имя_ex1 AND имя_ex2 — > ERR
Пользовательское исключение должно быть определено:
DECLARE
e_my_ex EXCEPTION;
…
BEGIN
IF (…) THEN
RAISE e_my_ex;
END IF;
…
EXCEPTION
WHEN e_my_ex THEN
…
END;
/
После перехвата более специализированных исключений:
WHEN … THEN
…
WHEN … THEN
мы можем перехватить все остальные исключения с помощью:
WHEN OTHERS THEN
…
Обработчик OTHERS рекомендуется помещать на самом высоком уровне программы:
(В самом высшем блоке)
для обеспечения распознавания всех возможных ошибок.
Иначе ошибки будут распространяться в вызывающую среду и возможны
нежелательные последствия, такие как откат на сервере текущей транзакции.
Не используйте в промышленном коде такое:
WHEN OTHERS THEN NULL;
т.к. оно будет молчаливо перехватывать все неожиданные ошибки не сообщая,
что они произошли.
Обработчик OTHERS должен регистрировать ошибку и возможно предоставлять
дополнительную информацию для дальнейшего исследования.
WHEN OTHERS THEN
INSERT INTO log_table(info) VALUES (‘Another error occurred.’);
END;
/
Информацию об ошибках можно получить при помощи двух встроенных функций:
— SQLCODE
— SQLERRM
первая возвращает код текущей ошибки а вторая текст сообщения об ошибке
Для исключений определенных пользователем:
SQLCODE возвращает 1
а
SQLERRM «User-defined Exception»
WHEN OTHERS THEN
v_ErrorCode := SQLCODE;
v_ErrorText := SUBSTR(SQLERRM, 1, 200);
INSERT INTO log_tab(code, message, info) VALUES (v_ErrorCode, v_ErrorText, ‘Oracle error.’);
END;
/
В таблице log_tab поле message ограничено 200 символами
и чтобы не произошло ошибки при вставке, мы урезаем длину
сообщения до 200 символов с помощью SUBSTR
А то максимальная длина сообщения может достигать 512 символов.
Функция SQLERRM может принимать один числовой аргумент.
При этом она возвратит текст сообщения об ошибке, код которой равен заданному числу.
Аргумент должен быть всегда отрицательным числом.
Если аргумент равен 0, то будет возвращено сообщение:
ORA-0000: normal, succesful completion
При положительном аргументе не равном 100 будет возвращено сообщение:
non-ORACLE Exception
А при
SQLERRM(100) — > ORA-1403: no data found
Это исключение ANSI
Остальные коды ошибок Oracle все отрицательные.
Для получения информации об ошибке можно также использовать функцию
FORMAT_ERROR_STACK из пакета DBMS_UTILITY
Её можно непосредственно использовать в операторах SQL:
WHEN OTHERS THEN
INSERT INTO log_tab(code, message, info) VALUES (NULL,
SUBSTR(DBMS_UTILITY.FORMAT_ERROR_STACK, 1, 200),
‘Oracle error occurred.’);
END;
/
Ещё одна функция.
DBMS_UTILITY.FORMAT_ERROR_BACKTRACE
она аналогична FORMAT_ERROR_STACK
но не подвержена ограничению длины сообщения в 2000 байт.
Она возвращает полностью весь стек ошибок на момент инициирования исключительной ситуации.
Любое именованное исключение можно связать с конкретной ошибкой ORACLE.
Например, в ORACLE есть стандартная ошибка ORA-1400, которая возникает при пропуске значения
или вставке значения NULL в столбец с ограничением NOT NULL.
ORA-1400: mandatory NOT NULL column missing or NULL during insert.
Мы хотим создать свое пользовательское именованное исключение и связать его с этой стандартной ошибкой ORA-1400
DECLARE
e_my_ex EXCEPTION;
PRAGMA EXCEPTION_INIT(e_my_ex, -1400);
BEGIN
WHEN e_my_ex THEN
INSERT INTO log_tab(info) VALUES (‘ORA-1400 occurred.’);
END;
/
Теперь мы перехватываем её по имени с помощъю WHEN или THEN
Все стандартные исключительные ситуации также ассоциируются с соответствующими им ошибками Oracle
при помощи прагмы EXCEPTION_INIT в пакете STANDARD
VALUE_ERROR — > ORA-6501
TO_MANY_ROWS — > ORA-1422
ZERO_DIVIDE — > ORA-1476
……….
и т.д.
Так что если вам не хватает некоего имени конкретной ошибки ORA-NNNN,
то придумайте свое имя и свяжите его с ошибкой с помощью прагмы : EXCEPTION_INIT
Для собственных пользовательских исключений можно придумать свои коды ошибок, которые разрешено брать из диапазона:
-20000 до -20999
и придумать свой текст сообщения
RAISE_APPLICATION_ERROR(номер, текст, [флаг]);
TRUE — пополнить список ранее произошедших ошибок
FALSE — новая ошибка заместит текущий список ошибок (по умолчанию)
set serveroutput on
variable a NUMBER;
variable b NUMBER;
exec :a := 0;
exec :b := 10;
DECLARE
l_a NUMBER := :a;
l_b NUMBER := :b;
l_c NUMBER;
BEGIN
IF l_a = 0 THEN
raise_application_error(-20005, ‘Divizor is 0’);
END IF;
l_c := l_b / l_a;
dbms_output.put_line(‘The result: ‘||l_c);
EXCEPTION
WHEN OTHERS THEN
dbms_output.put_line(SQLERRM);
END;
/
Поскольку у исключения нет имени, то его может обработать только обработчик OTHERS
Но такое исключение можно и поименовать
и с помощью прагмы связать с нашим кодом.
DECLARE
my_ex EXCEPTION;
…..
…..
PRAGMA EXCEPTION_INIT(my_ex, -20005);
BEGIN
IF (…) THEN
raise_application_error(-20005, ‘Divizor is 0’);
…..
…..
EXCEPTION
WHEN my_ex THEN
dbms_output.put_line(SQLERRM);
END;
/
Теперь это исключение можно обработать по имени с помощью:
WHEN my_ex THEN
EXCEPTION PROPAGATION
enclosing block — обьемлющий блок
Если в текущем блоке имеется обработчик данной исключительной ситуации,
то он выполняется и блок успешно завершается.
Управление передаётся вышестоящему блоку.
Если обработчик отсутствует, исключительная ситуация передается в обьемлющий блок и инициируется там.
Если обьемлющего блока не существует, то исключение будет передано вызывающей среды (например SQL*Plus).
При вызове процедуры также может создаваться обьемлющий блок:
BEGIN
p(…); — вызов процедуры
EXCEPTION
WHEN OTHERS THEN
— исключение инициированное p()
— будет обработано здесь
END;
/
Исключения инициируемые в секции обьявлений (DECLARE) не обрабатываются секцией EXCEPTION
текущего блока, а передаются в EXCEPTION обьемлющего блока.
Тоже самое, если исключение инициируется в секции EXCEPTION,
то обработка данного исключения передается в обьемлющий блок.
Исключительную ситуацию можно обработать в текущем блоке и сразу снова установить
то же самое исключение, которое будет передано в обьемлющую область:
DECLARE
A EXCEPTION;
BEGIN
RAISE A;
EXCEPTION
WHEN A THEN
INSERT INTO log_tab(info) VALUES (‘Exception A occurred.’);
COMMIT;
RAISE;
END;
/
Тут commit гарантирует, что результаты insert будут зафиксированы
в базе данных в случае отката транзакции.
С помощью пакета UTL_FILE можно избежать необходимости commit
или используйте автономные транзакции.
Область действия исключительной ситуации
BEGIN
DECLARE
e_ex EXCEPTION; — видно по имени только внутри блока
BEGIN
RAISE e_ex;
END;
EXCEPTION
— тут исключение не видно по имени e_ex
— и его можно обработать с помощью обработчика OTHERS
WHEN OTHERS THEN
— инициируем это исключение повторно
RAISE; — Теперь это исключение передается вызывающей среде
END;
/
Если сообщение об ошибке, определяемой пользователем, нужно передать из блока,
рекомендуется описывать исключительную ситуацию и модуле так,
чтобы она была видима вне этого блока.
Или воспользуйтесь функцией : RAISE_APPLICATION_ERROR
Как описать исключение, которое будет видно вне блока?
Нужно создать пакет Globals и описать в нем пользовательское исключение.
Такая исключительная ситуация будет видима и во внешнем блоке.
CREATE OR REPLACE PACKAGE Globals AS
e_ex EXCEPTION;
END Globals;
BEGIN
BEGIN
RAISE Globals.e_ex;
END;
EXCEPTION
WHEN Globals.e_ex THEN
— инициируем повторно
— для передачи в вызывающую среду
RAISE;
END;
/
В пакете Globals можно также объявлять:
— таблицы
— переменные
— типы
Избегайте необработанных исключений
Нельзя допускать завершение программ, пока в них остаются необработанные исключения
Используйте обработчик OTHERS на самом верхнем уровне программы.
И пусть он регистрирует факт и время возникновения ошибки.
И ни одна ошибка не останется без внимания.
DECLARE
v_ErrorNumber NUMBER;
v_ErrorText VARCHAR2(200);
BEGIN
…
…
EXCEPTION
WHEN OTHERS THEN
…
v_ErrorNumber := SQLCODE;
v_ErrorText := SUBSTR(SQLERRM, 1, 200);
INSERT INTO log_tab(code, message, info)
VALUES (v_ErrorNumber, v_ErrorText,
‘Oracle error …at ‘ || to_char(sysdate, ‘DD-MON-YYHH24:MI:SS’));
END;
/
Можно использовать и утилиту DBMS_UTILITY.FORMAT_ERROR_BACKTRACE
она регистрирует первоначальное местовозникновения исключения.
Как определить, где произошла ошибка?
BEGIN
SELECT …
SELECT …
SELECT …
EXCEPTION
WHEN NO_DATA_FOUND THEN
— какой select инициировал ошибку?
END;
/
Можно создать счетчик, указывающий на sql — оператор:
DECLARE
v_sel_count NUMBER := 1;
BEGIN
SELECT …
v_sel_count := 2;
SELECT …
v_sel_count := 3;
SELECT …
EXCEPTION
WHEN NO_DATA_FOUND THEN
INSERT INTO log_tab(info)
VALUES (‘no data found in select ‘||v_sel_count);
END;
/
Можно разместить каждый select в собственном врутреннем блоке
BEGIN
BEGIN
SELECT …
EXCEPTION
WHEN NO_DATA_FOUND THEN
INSERT INTO log_tab(info)
VALUES (‘no data found in select 1’);
END;
BEGIN
SELECT …
EXCEPTION
WHEN NO_DATA_FOUND THEN
INSERT INTO log_tab(info)
VALUES (‘no data found in select 2’);
END;
BEGIN
SELECT …
EXCEPTION
WHEN NO_DATA_FOUND THEN
INSERT INTO log_tab(info)
VALUES (‘no data found in select 3’);
END;
END;
/
Или использовать : DBMS_UTILITY.FORMAT_ERROR_BACKTRACE
и потом анализировать файл трассировки.
Пусть в нашей программе Oracle выдает ошибку ORA-01844: not f valid month
перехватить его можно так:
EXCEPTION
WHEN OTHERS THEN
IF SQLCODE = -1843 THEN
Да, код плохо читаем.
Сделаем его более лучшим:
PROCEDURE my_procedure
IS
invalid_month EXCEPTION;
PRAGMA EXCEPTION_INIT(invalid_month, -1843);
BEGIN
….
EXCEPTION
WHEN invalid_month THEN
так уже более понятней.
В этом учебном материале вы узнаете, как использовать встроенные исключительные ситуации в Oracle/PLSQL c синтаксисом и примерами.
Описание
Встроенные исключительные ситуации это исключительные ситуации, которые имеют определенные имена в PL/SQL. Они определены в стандартном пакете в PL/SQL и не могут быть определены программистом.
Oracle имеет стандартный набор встроенных исключительных ситуаций:
| Исключительные ситуации ORACLE | Ошибки Oracle | Пояснения |
|---|---|---|
| DUP_VAL_ON_INDEX | ORA-00001 | Вы пытались выполнить операторы insert или update поля, изменение значения которого нарушит ограничение уникальности поля. |
| TIMEOUT_ON_RESOURCE | ORA-00051 | Возбуждается при возникновении таймаута, когда ORACLE ожидает ресурса. |
| TRANSACTION_BACKED_OUT | ORA-00061 | Откат удаленной части транзакции. |
| INVALID_CURSOR | ORA-01001 | Вы пытаетесь сослаться на курсор, который еще не существует. Это могло произойти потому, что вы выполняете выборку (fetch) курсора, который был закрыт (close) или не был открыт (open). |
| NOT_LOGGED_ON | ORA-01012 | Вы пытаетесь выполнить вызов в Oracle, не подключившись к Oracle. |
| LOGIN_DENIED | ORA-01017 | Вы пытаетесь войти в Oracle с неверными имя пользователя / пароль. |
| NO_DATA_FOUND | ORA-01403 | Вы пробовали один из следующих вариантов:
|
| TOO_MANY_ROWS | ORA-01422 | Вы пытались выполнить SELECT INTO и запрос вернул более одной строки. |
| ZERO_DIVIDE | ORA-01476 | Вы пытались поделить число на ноль. |
| INVALID_NUMBER | ORA-01722 | Вы пытаетесь выполнить оператор SQL который пытается преобразовать строку в число. |
| STORAGE_ERROR | ORA-06500 | Вы исчерпали доступную память или память повреждена. |
| PROGRAM_ERROR | ORA-06501 | Это общее сообщение Обратитесь в службу поддержки Oracle, возбуждается по причине обнаружения внутренней ошибки. |
| VALUE_ERROR | ORA-06502 | Вы пытались выполнить операцию и была ошибка преобразования, усечения, или ограничения числовых или символьных данных. |
| CURSOR_ALREADY_OPEN | ORA-06511 | Вы попытались открыть курсор, который уже открыт. |
Синтаксис
Рассмотри синтаксис встроенных исключительных ситуаций в процедуре и функции.
Синтаксис для процедуры
CREATE [OR REPLACE] PROCEDURE procedure_name
[ (parameter [,parameter]) ]
IS
[declaration_section]BEGIN
executable_sectionEXCEPTION
WHEN exception_name1 THEN
[statements]
WHEN exception_name2 THEN
[statements]
WHEN exception_name_n THEN
[statements]
WHEN OTHERS THEN
[statements]
END [procedure_name];
Синтаксис для функции
CREATE [OR REPLACE] FUNCTION function_name
[ (parameter [,parameter]) ]
RETURN return_datatype
IS | AS
[declaration_section]BEGIN
executable_sectionEXCEPTION
WHEN exception_name1 THEN
[statements]
WHEN exception_name2 THEN
[statements]
WHEN exception_name_n THEN
[statements]
WHEN OTHERS THEN
[statements]
END [function_name];
Пример использования исключительных ситуаций в процедуре.
|
CREATE OR REPLACE PROCEDURE add_new_supplier (supplier_id_in IN NUMBER, supplier_name_in IN VARCHAR2) IS BEGIN INSERT INTO suppliers (supplier_id, supplier_name ) VALUES ( supplier_id_in, supplier_name_in ); EXCEPTION WHEN DUP_VAL_ON_INDEX THEN raise_application_error (-20001,‘Вы пытались вставить дубликат supplier_id.’); WHEN OTHERS THEN raise_application_error (-20002,‘Произошла ошибка при вставке supplier.’); END; |
В этом примере, мы перехватываем исключительную ситуацию DUP_VAL_ON_INDEX. Мы можем также использовать WHEN OTHERS, чтобы перехватить остальные исключительные ситуации.
EXCEPTION блок
Обработка ошибок производится в блоке exception:
begin
-- Код
exception
-- Обработка ошибок
when .... then .....;
when .... then .....;
when .... then .....;
end;
Ошибки отлавливаются в пределах блока begin-end. Работает это так:
- Сначала выполняется код между
beginиexception - Если ошибок не произошло, тогда секция между
exceptionиendингорируется - Если в процессе выполнения кода происходит ошибка, выполнение останавливается
и переходит в блокexception. - Если в блоке находится обработчик для исключения, вызывается код после
then - Если обработчик не найден, исключение выбрасывается за пределы блока
begin-end
Пример блока с обработчиком исключений:
declare
l_val number;
begin
select 1 into l_var
where 2 > 3;
exception
when no_data_found then
dbms_output.put_line('Нет данных');
when dup_val_on_index then
dbms_output.put_line('Такая строка уже есть');
end;
Предопределённые ошибки
Ошибки обрабатываются по их имени, поэтому часть наиболее частых ошибок в PL/SQL
уже предопределена, как например вышеуказанные no_data_found и dup_val_on_index.
Ниже показан их список и в каких случаях ошибка может возникнуть.
| Ошибка | Когда возникает |
|---|---|
| ACCESS_INTO_NULL | Попытка присвоить значение атрибуту неинициализированного объекта. |
| CASE_NOT_FOUND | В выражении CASE не нашлось подходящего условия When, и в нём отсутствует условие Else. |
| COLLECTION_IS_NULL | Попытка вызвать любой метод коллеции(за исключением Exists) в неинициализированной вложенной таблице или ассоциативном массиве, или попытка присвоить значения элементам неинициализированной вложенной таблице или ассоциативного массива. |
| CURSOR_ALREADY_OPEN | Попытка открыть уже открытый курсор. Курсор должен быть закрыт до момента его открытия. Цикл FOR автоматически открывает курсор, который использует, поэтому его нельзя открывать внутри тела цикла. |
| DUP_VAL_ON_INDEX | Попытка вставить в таблицу значения, которые нарушают ограничения, созданные уникальным индексом. Иными словами, ошибка возникает, когда в колонки уникального индекса добавляются дублирующие записи. |
| INVALID_CURSOR | Попытка вызова недопустимой операции с курсором, например закрытие не открытого курсора. |
| INVALID_NUMBER | Ошибка приведения строки в число в SQL запросе, потому что строка не является числовым представлением (В PL/SQL коде в таких случаях выбрасывается VALUE_ERROR). Также может возникнуть, если значение параметра LIMIT в выражении Bulk collect не является положительным числом. |
| LOGIN_DENIED | Попытка подключиться к БД с неправильным логином или паролем. |
| NO_DATA_FOUND | Выражение SELECT INTO не возвращает ни одной строки, или программа ссылается на удалённый элемент во вложенной таблице или неинициализированному объекту в ассоциативной таблице. Агрегатные функции в SQL, такие как AVG или SUM, всегда возвращают значение или null. Поэтому, SELECT INTO, которое вызывает только агрегатные функции, никогда не выбросит NO_DATA_FOUND. Выражение FETCH работает так, что ожидает отсутствия строк в определённый момент, поэтому ошибка также не выбрасывается. |
| NOT_LOGGED_ON | Обращение к БД будучи неподключенным к ней |
| PROGRAM_ERROR | Внутренняя проблема в PL/SQL. |
| ROWTYPE_MISMATCH | Курсорные переменные, задействованные в присваивании, имеют разные типы. |
| SELF_IS_NULL | Попытка вызвать метод неинициализированного объекта. |
| STORAGE_ERROR | Переполнение памяти или память повреждена. |
| SUBSCRIPT_BEYOND_COUNT | Попытка обратиться к элементу вложенной таблицы или ассоциативного массива по индексу, который больше, чем количество элементов в коллекции. |
| SUBSCRIPT_OUTSIDE_LIMIT | Попытка обратиться к элементу коллекции по индексу(например, -1) вне допустимого диапазона. |
| SYS_INVALID_ROWID | Ошибка конвертации строки в rowid. |
| TIMEOUT_ON_RESOURCE | Возникает при ожидании доступности ресурса. |
| TOO_MANY_ROWS | Выражение SELECT INTO возвращает более одной строки. |
| VALUE_ERROR | Арифметическая ошибка, ошибка конвертации, или превышение размерности типа. Может возникнуть, к примеру, если в переменную с типом number(1) попытаться присвоить значение 239. |
| ZERO_DIVIDE | Попытка деления на ноль. |
Объявление собственных ошибок
Можно объявлять собственные исключения, давая им
названия, которые полнее раскрывают их суть.
declare
-- Объявление собственного исключения,
-- которое мы выбрасываем, если значение заработной
-- платы ниже дозволенного минимума.
exc_too_low_salary exception;
l_salary number := 100;
begin
if l_salary < 200 then
-- Бросаем ошибку.
raise exc_too_low_salary;
end if;
exception
when exc_too_low_salary then
dbms_output.put_line('Обработчик исключения');
end;
Область видимости собственного исключения в данном случае — блок, в котором оно
объявлено. Вне этого блока обработать исключение не получится.
Для более удобной работы с собственными исключениями их можно вынести в отдельный пакет:
create or replace pck_hr_errors is
-- Объявляем исключения в спецификации пакета.
-- Тела пакет не имеет, только спецификацию.
exc_wrong_name exception;
exc_too_low_salary exception;
exc_incorrect_pass exception;
end;
Далее работать с этими исключениями можно подобным образом:
begin
-- Какой-то код
...
exception
when pck_hr_errors.exc_too_low_salary then
-- Обработка исключения
...
end;
Обработка непредопределённых ошибок
Не все ошибки в Oracle являются предопределёнными. Когда возникает необходимость
их обрабатывать, нужно связать переменную типа exception с кодом ошибки, которую нужно обработать:
declare
-- объявляем ошибку
e_incorrect_date exception;
-- связываем ошибку с кодом
pragma exception_init(e_incorrect_date, -1830);
begin
dbms_output.put_line(to_date('2022-02-01', 'dd.mm.yyyy'));
exception
when e_incorrect_date then
dbms_output.put_line ('Неправильный формат даты');
end;
Следует помнить, что коды ошибок являются отрицательными числами.
Ошибки и вложенные блоки
Если ошибка не обрабатывается в пределах блока begin ..end,
она выбрасывается за его пределы. Далее эта ошибка может быть
обработана блоком exception внешнего блока. Если и там ошибка
не обрабатывается, она выбрасывается и за его пределы, и так
далее.
declare
a number;
-- Внешний блок
begin
-- Вложенный блок
begin
a := 1 / 0;
-- Важно помнить, что после возникновения ошибки
-- выполнение кода в пределах блока прекращается.
-- Следующий код не будет выполнен
dbms_output.put_line('Этот код не будет выполнен');
end;
exception
when zero_divide:
dbms_otuput.put_line('Ошибка обработана внешним блоком');
end;
raise_application_error
Если ошибка, брошенная Oracle, достигает клиентского приложения,
то она имеет примерно такой текст: ORA-01722 invalid number.
Процедура raise_application_error позволяет вызвать исключение
с заданным номером, связать его с сообщением и отправить его
вызывающему приложению.
begin
raise_application_error(-20134, 'Неправильный номер паспорта');
end;
Диапазон возможных кодов ошибок [-20999, 20000]. Сообщение должно
помещаться в тип varchar2(2000).
Можно указать третий boolean параметр, который в случае
значения true добавит текущую ошибку в список предыдущих
ошибок, возникших в приложении. По умолчанию значение равно false,
что значит, про сообщение об ошибке заменяет все предыдущие ошибки
собой.
Мы можем объявить собственное исключение, связать его с номером
в диапазоне [-20999, 20000] и использовать для обработки исключений,
брошенных с помощью raise_application_error:
declare
e_wrong_passport exception;
-- связываем ошибку с кодом
pragma exception_init(e_wrong_passport, -20999);
begin
raise_application_error(-20999, 'Неправильный номер паспорта');
exception
when e_wrong_password then
dbms_output.put_line ('Неправильный номер паспорта');
end;
October 11, 2020
ORACLE
This article contains information about Oracle PL/SQL Exception and Types such as system defined, user defined.
What is Exception in Oracle PL/SQL?
These are the structures used for the management of errors that occur during the execution of commands.
Oracle PL/SQL Exception Types
- System-defined
- User-defined
The use of the PL / SQL Exception structure is as follows.
|
DECLARE — definitions BEGIN — commands EXCEPTION WHEN HATA—TURU THEN — commands WHEN OTHERS THEN — commands END; |
Sample Exception Usage is as follows;
|
BEGIN DBMS_OUTPUT.put_line(3/0); EXCEPTION WHEN ZERO_DIVIDE THEN DBMS_OUTPUT.put_line(‘Divide by zero error.’); WHEN OTHERS THEN DBMS_OUTPUT.put_line(‘unknown error.’); END; |
System Defined Exceptions in Oracle PL/SQL
The Exception type previously created by Oracle PL / SQL is called System defined.
System-defined exception types are listed below.
- ACCESS_INTO_NULL
- ASE_NOT_FOUND
- COLLECTION_IS_NULL
- DUP_VAL_ON_INDEX
- INVALID_CURSOR
- INVALID_NUMBER, LOGIN_DENIED
- NO_DATA_FOUND
- NOT_LOGGED_ON
- PROGRAM_ERROR
- ROWTYPE_MISMATCH
- SELF_IS_NULL
- STORAGE_ERROR
- TOO_MANY_ROWS
- VALUE_ERROR
- ZERO_DIVIDE
User Defined Exceptions in Oracle PL/SQL
Oracle also allows custom exception definition. These Exception types are called user defined exceptions. You can create User Defined Exception as follows.
|
DECLARE MY_CUSTOM_ERROR EXCEPTION; BEGIN NULL; END; |
We can set a special error code for the exception as follows.
|
DECLARE CUSTOM_ERROR EXCEPTION; PRAGMA EXCEPTION_INIT (CUSTOM_ERROR, —1453); BEGIN NULL; END; |
The occured error can be triggered by RAISE.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
SET SERVEROUTPUT ON; DECLARE CUSTOM_ERROR EXCEPTION; PRAGMA EXCEPTION_INIT (CUSTOM_ERROR, —1453); v_sayi PLS_INTEGER := ‘0’; BEGIN IF v_sayi = 0 THEN RAISE CUSTOM_ERROR; — RAISE_APPLICATION_ERROR(—1453, ‘Another Error.’); END IF; EXCEPTION WHEN CUSTOM_ERROR THEN DBMS_OUTPUT.put_line(‘Special Error Occured.’); DBMS_OUTPUT.put_line(SQLERRM); WHEN OTHERS THEN DBMS_OUTPUT.put_line(‘Unknown Error Occured.’); END; |
The RAISE_APPLICATION_ERROR function takes the “error code”, “error message”, and “whether the error should be replaced with existing errors” as parameters to create a custom error.
You can find more detailed information about below topics in the below link.
PL/SQL Tutorial
You will find below topics in this article.
- What is PL/SQL
- Oracle PL/SQL Data Types and Variables and Literals
- Oracle PL/SQL Operators
- Oracle PL/SQL Conditional Statements
- Oracle PL/SQL Loops
- Oracle PL/SQL Procedures and Procedure Parameters
- Oracle PL/SQL Functions
- Oracle PL/SQL Cursor
- Oracle PL/SQL Records
- Oracle PL/SQL Exception
- Oracle PL/SQL Trigger
- Oracle PL/SQL Packages
- Oracle PL/SQL Collections
You can find more information about exception at docs.oracle.com
This page contains an Oracle SQLCODE list of errors that you may encounter when working with Oracle SQL. The codes are ANSI-standard, which means you should find them with all relational databases.s
The list of SQLCODE messages is shown below.