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) 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.
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;