FirebirdSQL logo

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 :

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

Exemples

Example 1. Créer une exception pour un utilisateur
CREATE EXCEPTION E_LARGE_VALUE 'La valeur dépasse la valeur maximale autorisée';
Example 2. Création d’une exception paramétrée
CREATE EXCEPTION E_INVALID_VALUE 'Valeur invalide de @1 pour le champ @2';

ALTER EXCEPTION

affectation

Modifier le texte du message d’exception de l’utilisateur.

Disponible en

DSQL, ESQL

Syntaxe
ALTER EXCEPTION exception_name '<message>'

Voir la syntaxe pour plus de détails CREATE EXCEPTION

L’instruction `ALTER EXCEPTION' modifie le texte du message d’exception de l’utilisateur.