RAISERROR |
Augmenter l'erreur |
---|---|
SQL Server | Microsoft SQL Server |
Syntaxe
RAISERROR( { msg_id | msg_str } { , severity , state } [ , argument [ ,...n ] ] ) [ WITH option [ ,...n ] ] |
Paramètres
Nom | Description | ||
---|---|---|---|
msg_id | Ce paramètre permet d'indiquer le message d'erreur utilisateur entreposé dans la table «sysmessages». | ||
msg_str | Ce paramètre permet d'indiquer le message «ad hoc» avec un formatage similaire à la fonction printf du langage de programmation C. Ainsi, il exploitera le format suivant : | ||
% [[flag] [width] [precision] [{h | l}]] type | |||
Sous-paramètre | Description | ||
flag | Ce sous-paramètre permet d'indiquer l'espace et la justification du message d'erreur utilisateur. | ||
Code | Description | ||
- (moins) | Ce code permet d'indiquer une justification à gauche. | ||
préfixe + (plus) ou - (minus) | Ce code permet d'indiquer la préférence de sortie. | ||
0 (zéro) | Ce code permet d'indiquer si la largeur est remplis de zéro pour atteindre la largeur minimum. | ||
# (nombre) | Ce code permet d'indiquer le nombre. Le préfixe «0x» permet d'indiquer le type hexadécimal de «x» ou «X». | ||
' ' (Espace blanc) | Ce code permet d'indiquer que la sortie de la valeur à des espaces blanc si la valeur est signé et positif. | ||
width | Ce sous-paramètre permet d'indiquer la largeur maximum sous forme d'une valeur entière. | ||
precision | Ce sous-paramètre permet d'indiquer le nombre maximum de caractères à envoyer vers le champ de sortie ou le nombre minimum de chiffre à envoyer dans la valeur entière. | ||
{h | l} type | Ce sous-paramètre permet d'indiquer le type de caractère et les valeurs de création. | ||
Type de caractère | Description | ||
d | Ce type de caractère permet d'indiquer un entier signé. | ||
I | Ce type de caractère permet d'indiquer un entier signé. | ||
o | Ce type de caractère permet d'indiquer la valeur octal non-signé. | ||
p | Ce type de caractère permet d'indiquer un pointeur. | ||
s | Ce type de caractère permet d'indiquer une chaine de caractères. | ||
u | Ce type de caractère permet d'indiquer un entier non-signé, soit un nombre naturel. | ||
x | Ce type de caractère permet d'indiquer la valeur hexadécimal non-signé. | ||
X | Ce type de caractère permet d'indiquer la valeur hexadécimal non-signé. | ||
severity | Ce paramètre permet d'indiquer le niveau de sévérité utilisateur associé avec le message. | ||
state | Ce paramètre permet d'indiquer une représentation de l'appel de l'état de l'erreur, lequel est une valeur entre 1 et 127. | ||
argument | Ce paramètre permet d'indiquer les paramètres utilisés dans la substitution des variables définies dans le paramètre «msg_str» ou le message correspondant au paramètre «msg_id». La valeur de ce dernier peut être o ou plus pour une substitution de paramètres; cependant le nombre total de paramètres de substitution ne peut pas dépasser 20. Chaque paramètre de substitution peut être une variable local ou n'importe quel type de données parmi ceux-ci : int1, int2, int4, char, varchar, binary ou varbinary. | ||
option | Ce paramètre permet d'indiquer l'option utilisateur de l'erreur. Cette option peut avoir les constantes suivantes | ||
Constante | Description | ||
LOG | Cette constante permet d'indiquer qu'il faut enregistrer les erreurs du journal de bord dans le journal de bord du serveur et de l'application. La taille d'une erreur est actuellement limité à un maximum de 440 octets. | ||
NOWAIT | Cette constante permet d'indiquer d'envoyer les messages immédiatement au client. | ||
SETERROR | Cette constante permet de fixer la valeur @@ERROR au paramètre «msg_id» ou à 50000, dépendamment du niveau de sévérité. |
Description
Cette instruction permet de générer un message d'erreur et d'initier un traitement d'erreur pour la session.
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Dimanche, le 7 juin 2015