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