sp_audit_write (Transact-SQL)
Fügt der USER_DEFINED_AUDIT_GROUP ein benutzerdefiniertes Überwachungsereignis hinzu. Wenn USER_DEFINED_AUDIT_GROUP nicht aktiviert ist, wird sp_audit_write ignoriert.
Gilt für: SQL Server (SQL Server 2012 bis aktuelle Version). |
.gif "Themenlink (Symbol)")
Transact-SQL-Syntaxkonventionen
Syntax
sp_audit_write [ @user_defined_event_id = ] user_defined_event_id ,
[ @succeeded = succeeded
[ , [ @user_defined_information = ] 'user_defined_information' ]
[ ; ]
Argumente
@user_defined_event_id
Ein vom Benutzer definierter und in der user_defined_event_id-Spalte des Überwachungsprotokolls aufgezeichneter Parameter. @user\_defined\_event\_id ist vom Datentyp smallint.@succeeded
Ein vom Benutzer übergebener Parameter, mit dem angegeben wird, ob das Ereignis erfolgreich war. Dies wird in der Spalte Erfolgreich des Überwachungsprotokolls angezeigt. @succeeded ist vom Datentyp bit.@user_defined_information
Der vom Benutzer definierte und in der Spalte user_defined_event_id des Überwachungsprotokolls aufgezeichnete Text. @user\_defined\_information ist vom Datentyp nvarchar(4000).
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
Fehler entstehen durch falsche Eingabeparameter oder Fehler beim Schreiben in das Zielüberwachungsprotokoll.
Hinweise
Wenn USER_DEFINED_AUDIT_GROUP entweder einer Serverüberwachungs- oder Datenbanküberwachungsspezifikation hinzugefügt wird, wird das von sp_audit_write ausgelöste Ereignis in das Überwachungsprotokoll eingeschlossen.
Berechtigungen
Erfordert die Mitgliedschaft in der public-Datenbankrolle.
Beispiele
A.Erstellen eines benutzerdefinierten Überwachungsereignisses mit Informationstext
Im folgenden Beispiel wird ein Überwachungsereignis mit der ID 27, dem Erfolgswert 0 und optionalem Informationstext erstellt.
EXEC sp_audit_write @user_defined_event_id = 27 ,
@succeeded = 0
, @user_defined_information = N'Access to a monitored object.' ;
B.Erstellen eines benutzerdefinierten Überwachungsereignisses ohne Informationstext
Im folgenden Beispiel wird ein Überwachungsereignis mit der ID 27 und dem Erfolgswert 0 erstellt. Optionaler Informationstext oder die Namen der optionalen Parameter werden nicht einbezogen.
EXEC sp_audit_write 27, 0;
Siehe auch
Verweis
Gespeicherte Sicherheitsprozeduren (Transact-SQL)
sys.server_principals (Transact-SQL)