Partage via


sp_audit_write (Transact-SQL)

S'applique à : SQL Server

Ajoute un événement d’audit défini par l’utilisateur à USER_DEFINED_AUDIT_GROUP. Si USER_DEFINED_AUDIT_GROUP elle n’est pas activée, sp_audit_write elle est ignorée.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @user_defined_event_id = ] user_defined_event_id

Paramètre défini par l’utilisateur et enregistré dans la user_defined_event_id colonne du journal d’audit. @user_defined_event_id est petit.

[ @succeeded = ] réussi

Paramètre passé par l'utilisateur pour indiquer si l'événement a ou non réussi. Cette valeur apparaît dans la succeeded colonne du journal d’audit. @succeeded est bit.

[ @user_defined_information = ] N’user_defined_information'

Texte défini par l’utilisateur et enregistré dans la nouvelle user_defined_event_id colonne du journal d’audit. @user_defined_information est nvarchar(4000).

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Les défaillances sont causées par des paramètres d’entrée incorrects ou par un échec d’écriture dans le journal d’audit cible.

Notes

Lorsque l’événement USER_DEFINED_AUDIT_GROUP est ajouté à une spécification d’audit de serveur ou à une spécification d’audit de 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 publique .

Exemples

R. Créer un événement d’audit défini par l’utilisateur avec du texte d’information

L’exemple suivant crée un événement d’audit avec la @user_defined_event_id valeur 27, la @succeeded valeur de 0, et inclut du texte d’information facultatif.

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

B. Créer un événement d’audit défini par l’utilisateur sans texte d’information

L’exemple suivant crée un événement d’audit avec la @user_defined_event_id valeur 27, la @succeeded valeur de 0, et n’inclut pas de texte d’information facultatif ou les noms de paramètres facultatifs.

EXEC sp_audit_write 27, 0;