sp_audit_write (Transact-SQL)

Artikel
06/18/2013

Fügt der USER_DEFINED_AUDIT_GROUP ein benutzerdefiniertes Überwachungsereignis hinzu. Wenn USER_DEFINED_AUDIT_GROUP nicht aktiviert ist, wird sp_audit_write ignoriert.

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.