Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S'applique à :
SQL Server
Modifie l’état des messages définis par l’utilisateur ou système dans une instance du Moteur de base de données SQL Server. Les messages définis par l’utilisateur peuvent être affichés à l’aide de l’affichage sys.messages catalogue.
Conventions de la syntaxe Transact-SQL
Syntaxe
sp_altermessage
[ @message_id = ] message_id
, [ @parameter = ] N'parameter'
, [ @parameter_value = ] 'parameter_value'
[ ; ]
Les arguments
[ @message_id = ] message_id
Numéro d’erreur du message à modifier.sys.messages
@message_id est int, sans valeur par défaut.
[ @parameter = ] N’parameter'
Utilisé avec @parameter_value pour indiquer que le message doit être écrit dans le journal des applications Windows. @parameter est sysname, sans valeur par défaut.
@parameter doit être défini sur WITH_LOG ou NULL. Si @parameter est défini WITH_LOG sur ou NULL, et que la valeur de @parameter_value est true, le message est écrit dans le journal des applications Windows. Si @parameter est défini WITH_LOG sur ou NULL si la valeur de @parameter_value est false, le message n’est pas toujours écrit dans le journal des applications Windows, mais peut être écrit en fonction de la façon dont l’erreur a été générée.
Si un message est écrit dans le journal des applications Windows, il est également écrit dans le fichier journal des erreurs du moteur de base de données.
Si @parameter est spécifié, @parameter_value doit également être spécifié.
[ @parameter_value = ] 'parameter_value'
Utilisé avec @parameter pour indiquer que l’erreur doit être écrite dans le journal des applications Windows. @parameter_value est varchar(5), sans valeur par défaut.
- Si
true, l’erreur est toujours écrite dans le journal des applications Windows. - Si
false, l’erreur n’est pas toujours écrite dans le journal des applications Windows, mais peut être écrite en fonction de la façon dont l’erreur a été générée.
Si @parameter_value est spécifié, @parameter doit également être spécifié.
Valeurs des codes de retour
0 (réussite) or 1 (échec).
Jeu de résultats
Aucune.
Notes
L’effet de sp_altermessage l’option WITH_LOG est similaire à celui du paramètre, sauf que RAISERROR WITH LOG change le comportement de sp_altermessage journalisation d’un message existant. Si un message est modifié, WITH_LOGil est toujours écrit dans le journal des applications Windows, quel que soit le mode d’appel de l’erreur par un utilisateur. Même si RAISERROR elle est exécutée sans option WITH_LOG , l’erreur est écrite dans le journal des applications Windows.
Les messages système peuvent être modifiés à l’aide sp_altermessagede .
autorisations
Nécessite l’appartenance au rôle serveur fixe serveradmin .
Exemples
L’exemple suivant écrit le message 55001 existant dans le journal des applications Windows.
EXECUTE sp_altermessage 55001, 'WITH_LOG', 'true';
GO