Une exception utilisateur est un objet de base de données qui décrit un message d’erreur. Une exception peut être appelée et traitée dans le code PSQL. (см. EXCEPTION, WHEN … DO).
Cette section décrit les opérateurs permettant de créer, modifier et supprimer les exceptions.
CREATE EXCEPTIONCréez une exception personnalisée à utiliser dans les modules PSQL.
DSQL, ESQL
CREATE EXCEPTION exception_name '<message>'
<message> ::= <message-part> [<message-part> ...]
<message-part> ::=
<text>
| @<slot>
<slot> ::= one of 1..9
| 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. |
L’instruction CREATE EXCEPTION peut être exécutée :
Utilisateurs avec le privilège CREATE EXCEPTION.
L’utilisateur qui a créé l’exception devient le propriétaire de l’exception.
CREATE EXCEPTION E_LARGE_VALUE 'La valeur dépasse la valeur maximale autorisée';CREATE EXCEPTION E_INVALID_VALUE 'Valeur invalide de @1 pour le champ @2';ALTER EXCEPTION, CREATE OR ALTER EXCEPTION, DROP EXCEPTION, RECREATE EXCEPTION, EXCEPTION.
ALTER EXCEPTIONModifier le texte du message d’exception de l’utilisateur.
DSQL, ESQL
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.
L’instruction `ALTER EXCEPTION' peut être exécutée :
Le propriétaire de l’exception ;
Utilisateurs avec le privilège `ALTER ANY EXCEPTION'.
ALTER EXCEPTION E_LARGE_VALUE 'La valeur dépasse la valeur maximale autorisée';CREATE EXCEPTION, CREATE OR ALTER EXCEPTION, RECREATE EXCEPTION.
CREATE OR ALTER EXCEPTIONCréez une nouvelle exception ou modifiez une exception existante.
DSQL
CREATE OR ALTER EXCEPTION exception_name '<message>'
Voir la syntaxe pour plus de détails CREATE EXCEPTION
Si une exception n’existe pas, elle sera créée. Une exception déjà existante sera modifiée, tandis que les dépendances d’exception existantes seront conservées.
CREATE OR ALTER EXCEPTION E_LARGE_VALUE
'La valeur dépasse la valeur maximale autorisée';DROP EXCEPTIONSuppression d’une exception d’utilisateur.
DSQL, ESQL
DROP EXCEPTION exception_name
| Paramètre | Description |
|---|---|
exception_name |
Le nom de l’exception. |
L’instruction DROP EXCEPTION supprime une exception personnalisée. S’il existe des dépendances pour une exception existante, la suppression n’aura pas lieu.
L’instruction DROP EXCEPTION peut être exécutée :
Le propriétaire de l’exception ;
Utilisateurs avec le privilège `DROP ANY EXCEPTION'.
DROP EXCEPTION E_LARGE_VALUE;RECREATE EXCEPTIONCréer ou recréer une exception utilisateur.
DSQL
RECREATE EXCEPTION exception_name '<message>'
Voir la syntaxe pour plus de détails CREATE EXCEPTION
L’instruction RECREATE EXCEPTION crée ou recrée une exception personnalisée. Si une exception portant ce nom existe déjà, l’instruction RECREATE EXCEPTION tentera de la supprimer et de créer une nouvelle exception. S’il existe des dépendances pour une exception existante, l’instruction RECREATE EXCEPTION ne sera pas exécutée.
RECREATE EXCEPTION E_LARGE_VALUE 'La valeur dépasse la valeur maximale autorisée';CREATE EXCEPTION, ALTER EXCEPTION, CREATE OR ALTER EXCEPTION.