Megosztás a következőn keresztül:


sp_audit_write (Transact-SQL)

A következőkre vonatkozik:SQL Server

Felhasználó által definiált naplózási eseményt ad hozzá a USER_DEFINED_AUDIT_GROUP. Ha USER_DEFINED_AUDIT_GROUP nincs engedélyezve, a sp_audit_write figyelmen kívül hagyja.

Transact-SQL szintaxis konvenciói

Szintaxis

sp_audit_write [ @user_defined_event_id = ] user_defined_event_id
    [ , [ @succeeded = ] succeeded ]
    [ , [ @user_defined_information = ] N'user_defined_information' ]
[ ; ]

Érvek

Fontos

A kiterjesztett tárolt eljárások argumentumait a Szintaxis szakaszban leírt sorrendben kell megadni. Ha a paraméterek sorrenden kívül vannak beírva, hibaüzenet jelenik meg.

[ @user_defined_event_id = ] user_defined_event_id

A felhasználó által definiált és a napló user_defined_event_id oszlopában rögzített paraméter. @user_defined_event_id.

[ @succeeded = ] sikeres volt

A felhasználó által átadott paraméter jelzi, hogy az esemény sikeres volt-e vagy sem. Ez az érték a napló succeeded oszlopában jelenik meg. @succeededbit.

[ @user_defined_information = ] N'user_defined_information'

A felhasználó által definiált és a napló új user_defined_event_id oszlopában rögzített szöveg. @user_defined_informationnvarchar(4000).

Kódértékek visszaadása

0 (sikeres) vagy 1 (hiba).

A hibákat helytelen bemeneti paraméterek vagy a célnaplóba való írás meghiúsulása okozza.

Megjegyzések

Amikor a USER_DEFINED_AUDIT_GROUP kiszolgálói vagy adatbázis-naplózási specifikációhoz ad hozzá, a sp_audit_write által aktivált esemény szerepel a naplóban.

Engedélyek

A nyilvános adatbázis-szerepkör tagságát igényli.

Példák

Egy. Felhasználó által definiált naplózási esemény létrehozása tájékoztató szöveggel

Az alábbi példa egy @user_defined_event_id27értékkel, a 0@succeeded értékével rendelkező naplózási eseményt hoz létre, és opcionális tájékoztató szöveget tartalmaz.

EXECUTE sp_audit_write
    @user_defined_event_id = 27,
    @succeeded = 0,
    @user_defined_information = N'Access to a monitored object.';

B. Felhasználó által definiált naplózási esemény létrehozása tájékoztató szöveg nélkül

Az alábbi példa egy @user_defined_event_id27értékkel, a 0@succeeded értékével rendelkező naplózási eseményt hoz létre, és nem tartalmazza az opcionális tájékoztató szöveget vagy az opcionális paraméterneveket.

EXECUTE sp_audit_write 27, 0;