Section courante

A propos

Section administrative du site

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