Teilen über


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;