Пользовательское исключение (exception) — объект базы данных, описывающий сообщение об ошибке.Исключение можно вызывать и обрабатывать в PSQL коде (см. EXCEPTION, WHEN … DO).

В данном разделе описываются операторы создания, модификации и удаления исключений.

`CREATE EXCEPTION`

Назначение

Создание пользовательского исключения для использования в PSQL модулях.

Доступно в

DSQL, ESQL

Синтаксис

CREATE EXCEPTION exception_name '<message>'

<message> ::= <message-part> [<message-part> ...]

<message-part> ::=
    <text>
  | @<slot>

<slot> ::= one of 1..9

Table 1. Параметры оператора `CREATE EXCEPTION`
Параметр	Описание
exception_name	Имя исключения.Максимальная длина 63 символов.
message	Сообщение об ошибке.Максимальная длина ограничена 1021 символом.
text	Текст.
slot	Номер слота для параметра.Нумерация начинается с 1.Максимальный номер слота равен 9.

Оператор CREATE EXCEPTION создаёт новое пользовательское исключение для использования в PSQL модулях.Исключение должно отсутствовать в базе данных, иначе будет выдана соответствующая ошибка.

Имя исключения является стандартным идентификатором.В диалекте 3 оно может быть заключено в двойные кавычки, что делает его чувствительным к регистру.Подробности см. Идентификаторы.

Сообщение исключения сохраняется в наборе символов NONE, т.е.любых символов из однобайтовых наборов символов.Текст сообщения может быть переопределён в PSQL коде во время возбуждения исключения.

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

Warning

Внимание!

Если в тексте сообщения, встретится номер слота параметра больше 9, то второй и последующий символ будут восприняты как литералы.Например, @10 будет воспринято как @1, после которого следует литерал 0.

Note	Пользовательские исключения хранятся в таблице RDB$EXCEPTION.

docnext count = 12

Кто может создать исключение?

Выполнить оператор CREATE EXCEPTION могут:

Администраторы
Пользователи с привилегией CREATE EXCEPTION.

Пользователь, создавший исключение, становится его владельцем.

Примеры

Example 1. Создание пользовательского исключения

CREATE EXCEPTION E_LARGE_VALUE 'Значение превышает предельно допустимое';

Example 2. Создание параметризованного исключения

CREATE EXCEPTION E_INVALID_VALUE
'Неверное значение @1 для поля @2';

См. также:

ALTER EXCEPTION,CREATE OR ALTER EXCEPTION,DROP EXCEPTION,RECREATE EXCEPTION,EXCEPTION.

`ALTER EXCEPTION`

Назначение

Изменение текста сообщения пользовательского исключения.

Доступно в

DSQL, ESQL

Синтаксис

ALTER EXCEPTION exception_name '<message>'

Подробнее см. в синтаксисе CREATE EXCEPTION

Оператор ALTER EXCEPTION изменяет текст сообщения пользовательского исключения.

Кто может изменить исключение?

Выполнить оператор ALTER EXCEPTION могут:

Администраторы
Владелец исключения;
Пользователи с привилегией ALTER ANY EXCEPTION.

Примеры

Example 1. Изменение текста сообщения пользовательского исключения

ALTER EXCEPTION E_LARGE_VALUE 'Значение превышает максимально допустимое';

См. также:

CREATE EXCEPTION,CREATE OR ALTER EXCEPTION,RECREATE EXCEPTION.

`CREATE OR ALTER EXCEPTION`

Назначение

Создание нового или изменение существующего исключения.

Доступно в

DSQL

Синтаксис

CREATE OR ALTER EXCEPTION exception_name '<message>'

Подробнее см. в синтаксисе CREATE EXCEPTION

Если исключения не существует, то оно будет создано.Уже существующее исключение будет изменено, при этом существующие зависимости исключения будут сохранены.

Примеры

Example 1. Создание или изменение пользовательского исключения

CREATE OR ALTER EXCEPTION E_LARGE_VALUE
'Значение превышает максимально допустимое';

См. также:

CREATE EXCEPTION,ALTER EXCEPTION,RECREATE EXCEPTION.

`DROP EXCEPTION`

Назначение

Удаление пользовательского исключения.

Доступно в

DSQL, ESQL

Синтаксис

DROP EXCEPTION exception_name

Table 1. Параметры оператора `DROP EXCEPTION`
Параметр	Описание
exception_name	Имя исключения.

Оператор DROP EXCEPTION удаляет пользовательское исключение.При наличии зависимостей для существующего исключения удаления не будет выполнено.

Кто может удалить исключение?

Выполнить оператор DROP EXCEPTION могут:

Администраторы
Владелец исключения;
Пользователи с привилегией DROP ANY EXCEPTION.

Примеры

Example 1. Удаление пользовательского исключения

DROP EXCEPTION E_LARGE_VALUE;

См. также:

CREATE EXCEPTION, RECREATE EXCEPTION.

`RECREATE EXCEPTION`

Назначение

Создание или пересоздание пользовательского исключения.

Доступно в

DSQL

Синтаксис

RECREATE EXCEPTION exception_name '<message>'

Подробнее см. в синтаксисе CREATE EXCEPTION

Оператор RECREATE EXCEPTION создаёт или пересоздаёт пользовательское исключение.Если исключение с таким именем уже существует, то оператор RECREATE EXCEPTION попытается удалить его и создать новое исключение.При наличии зависимостей для существующего исключения оператор RECREATE EXCEPTION не выполнится.

Примеры

Example 1. Создание или пересоздание пользовательского исключения

RECREATE EXCEPTION E_LARGE_VALUE
'Значение превышает максимально допустимое';

См. также:

CREATE EXCEPTION,ALTER EXCEPTION,CREATE OR ALTER EXCEPTION.