sp_audit_write (Transact-SQL)

Article
08/19/2013

Ajoute un événement d'audit défini par l'utilisateur au USER_DEFINED_AUDIT_GROUP. Si USER_DEFINED_AUDIT_GROUP n'est pas activé, sp_audit_write est ignoré.

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

sp_audit_write [ @user_defined_event_id =  ] user_defined_event_id , 
        [ @succeeded =  succeeded 
    [ , [ @user_defined_information =  ] 'user_defined_information' ] 
    [ ; ]

Arguments

@user_defined_event_id
Paramètre défini par l'utilisateur et enregistré dans la colonne user_defined_event_id du journal d'audit. @user\_defined\_event\_id est de type smallint.
@succeeded
Paramètre passé par l'utilisateur pour indiquer si l'événement a ou non réussi. Il apparaît dans la colonne succeeded du journal d'audit. @succeeded est de type bit.
@user_defined_information
Texte défini par l'utilisateur et enregistré dans la nouvelle colonne user_defined_event_id du journal d'audit. @user\_defined\_information est de type nvarchar(4000).

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Les échecs sont dus à des paramètres d'entrée incorrects ou à l'impossibilité d'écrire dans le journal d'audit cible.

Notes

Lorsque USER_DEFINED_AUDIT_GROUP est ajouté à une spécification d'audit du serveur ou d'audit de la base de données, l'événement déclenché par sp_audit_write est inclus dans le journal d'audit.

Autorisations

Nécessite l'appartenance au rôle de base de données public.

Exemples

A.Création d'un événement d'audit défini par l'utilisateur avec du texte informatif

L'exemple suivant crée un événement d'audit présentant l'ID 27 et la valeur de réussite 0. Il inclut un texte informatif facultatif.

EXEC sp_audit_write @user_defined_event_id =  27 , 
              @succeeded =  0 
            , @user_defined_information = N'Access to a monitored object.' ;

B.Création d'un événement d'audit défini par l'utilisateur sans texte informatif

L'exemple suivant crée un événement d'audit présentant l'ID 27 et la valeur de réussite 0. Il n'inclut pas de texte informatif facultatif ou de noms de paramètres optionnels.