CREATE EXCEPTION

`CREATE EXCEPTION`

affectation

Créez une exception personnalisée à utiliser dans les modules PSQL.

Disponible en

DSQL, ESQL

Syntaxe

CREATE EXCEPTION exception_name '<message>'

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

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

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

Table 1. Paramètres de l’opérateur `CREATE EXCEPTION`
Paramètre	Description
exception_name	Nom de l’exception. Longueur maximale de 63 caractères.
message	Message d’erreur. La longueur maximale est limitée à 1021 caractères.
text	Texte.
slot	Le numéro d’emplacement du paramètre. La numérotation commence à 1. Le numéro d’emplacement maximum est 9.

L’instruction CREATE EXCEPTION crée une nouvelle exception personnalisée à utiliser dans les modules PSQL. L’exception ne doit pas exister dans la base de données, sinon une erreur appropriée sera lancée.

Le nom de l’exception est un identifiant standard. Dans le dialecte 3, il peut être entouré de guillemets doubles, ce qui le rend sensible à la casse. Voir Identifiers pour plus de détails.

Le message d’exception est enregistré dans le jeu de caractères NONE, c’est-à-dire n’importe quel caractère des jeux de caractères à un octet. Le texte du message peut être remplacé dans le code PSQL au moment où l’exception est levée.

Le message d’erreur peut contenir des emplacements de paramètres qui sont remplis lorsque l’exception est levée.

Warning

Attention!

Si un numéro d’emplacement de paramètre supérieur à 9 est rencontré dans le texte du message, le deuxième caractère et les suivants seront considérés comme des littéraux. Par exemple, @10 sera considéré comme @1 suivi du littéral 0.

Note	Les exceptions des utilisateurs sont stockées dans la table RDB$EXCEPTION.

Qui peut créer une exception ?

L’instruction CREATE EXCEPTION peut être exécutée :

Administrateurs
Utilisateurs avec le privilège CREATE EXCEPTION.

L’utilisateur qui a créé l’exception devient le propriétaire de l’exception.