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;
Contenu connexe
Commentaires
https://aka.ms/ContentUserFeedback.
Prochainement : Tout au long de l'année 2024, nous supprimerons progressivement les GitHub Issues en tant que mécanisme de retour d'information pour le contenu et nous les remplacerons par un nouveau système de retour d'information. Pour plus d’informations, voir:Soumettre et afficher des commentaires pour