sp_audit_write (Transact-SQL)
Gilt für: 
SQL Server
Fügt ein benutzerdefiniertes Überwachungsereignis hinzu.USER_DEFINED_AUDIT_GROUP Wenn USER_DEFINED_AUDIT_GROUP diese Option nicht aktiviert ist, sp_audit_write wird sie ignoriert.
Transact-SQL-Syntaxkonventionen
Syntax
sp_audit_write [ @user_defined_event_id = ] user_defined_event_id
[ , [ @succeeded = ] succeeded ]
[ , [ @user_defined_information = ] N'user_defined_information' ]
[ ; ]
Argumente
[ @user_defined_event_id = ] user_defined_event_id
Ein parameter, der vom Benutzer definiert und in der user_defined_event_id Spalte des Überwachungsprotokolls aufgezeichnet wird. @user_defined_event_id ist klein.
[ @succeeded = ] erfolgreich
Ein vom Benutzer übergebener Parameter, mit dem angegeben wird, ob das Ereignis erfolgreich war. Dieser Wert wird in der succeeded Spalte des Überwachungsprotokolls angezeigt. @succeeded ist bit
[ @user_defined_information = ] N'user_defined_information'
Der vom Benutzer definierte Und in der neuen user_defined_event_id Spalte des Überwachungsprotokolls aufgezeichnete Text. @user_defined_information ist nvarchar(4000)
Rückgabecodewerte
0 (erfolgreich) oder 1 Fehler.
Fehler werden durch falsche Eingabeparameter oder Fehler beim Schreiben in das Zielüberwachungsprotokoll verursacht.
Hinweise
Wenn das USER_DEFINED_AUDIT_GROUP Ereignis entweder einer Serverüberwachungsspezifikation oder einer Datenbanküberwachungsspezifikation hinzugefügt wird, wird das ausgelöste sp_audit_write Ereignis im Überwachungsprotokoll enthalten.
Berechtigungen
Erfordert die Mitgliedschaft in der public -Datenbankrolle.
Beispiele
A. Erstellen eines benutzerdefinierten Überwachungsereignisses mit Informationstext
Im folgenden Beispiel wird ein Überwachungsereignis mit einem @user_defined_event_id Wert von 27, dem @succeeded Wert von 0, und enthält optionalen Informationstext.
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 einem @user_defined_event_id Wert von 27, dem @succeeded Wert von 0, erstellt und enthält keinen optionalen Informationstext oder die optionalen Parameternamen.
EXEC sp_audit_write 27, 0;