xp_logevent (Transact-SQL)
Inscrit un message défini par l'utilisateur dans le fichier journal de SQL Server et dans l'Observateur d'événements Windows. xp_logevent peut être utilisé pour envoyer une alerte sans envoyer de message au client.
.gif "Icône Lien de rubrique")
Conventions de la syntaxe Transact-SQL
Syntaxe
xp_logevent { error_number , 'message' } [ , 'severity' ]
Arguments
error_number
Numéro d'erreur défini par l'utilisateur, supérieur à 50000. La valeur maximale est 2147483647 (2^31 - 1).'message'
Chaîne de caractères d'une longueur maximale de 2048 caractères.'severity'
Une des trois chaînes de caractères INFORMATIONAL, WARNING ou ERROR. severity est facultatif, avec INFORMATIONAL comme valeur par défaut.
Valeurs des codes de retour
0 (réussite) ou 1 (échec)
Jeux de résultats
xp_logevent retourne ce message d'erreur pour l'exemple de code ci-dessous :
The command(s) completed successfully.
Notes
Lorsque vous envoyez des messages à partir de déclencheurs, de lots, de procédures Transact-SQL, etc., utilisez l'instruction RAISERROR au lieu de xp_logevent. xp_logevent n'appelle pas de gestionnaire de messages d'un client et ne définit pas @@ERROR. Pour écrire des messages dans l'Observateur d'événements Windows et dans le journal des erreurs de SQL Server dans une instance SQL Server, exécutez l'instruction RAISERROR.
Autorisations
Nécessite l'appartenance au rôle de base de données fixe db_owner dans la base de données master ou l'appartenance au rôle serveur fixe sysadmin.
Exemples
Cet exemple enregistre le message dans l'Observateur d'événements Windows et transmet les variables au message.
DECLARE @@TABNAME varchar(30)
DECLARE @@USERNAME varchar(30)
DECLARE @@MESSAGE varchar(255)
SET @@TABNAME = 'customers'
SET @@USERNAME = USER_NAME()
SELECT @@MESSAGE = 'The table ' + @@TABNAME + ' is not owned by the user
' + @@USERNAME + '.'
USE master
EXEC xp_logevent 60000, @@MESSAGE, informational