Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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
Wichtig
Argumente für erweiterte gespeicherte Prozeduren müssen in der spezifischen Reihenfolge eingegeben werden, wie im Abschnitt Syntax beschrieben. Wenn die Parameter außerhalb der Reihenfolge eingegeben werden, tritt eine Fehlermeldung auf.
[ @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;