Partager 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

Important

Les arguments des procédures stockées étendues doivent être entrés dans l’ordre spécifique, comme décrit dans la section syntaxe. Si les paramètres sont entrés hors ordre, un message d’erreur se produit.

[ @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) or 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.

EXECUTE 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.

EXECUTE sp_audit_write 27, 0;