sp_audit_write (Transact-SQL)

Berlaku untuk: SQL Server (semua versi yang didukung)

Menambahkan peristiwa audit yang ditentukan pengguna ke USER_DEFINED_AUDIT_GROUP. Jika USER_DEFINED_AUDIT_GROUP tidak diaktifkan, sp_audit_write diabaikan.

Konvensi Sintaksis T-SQL

Sintaks

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

Argumen

[ @user_defined_event_id = ] user_defined_event_id
Parameter yang ditentukan oleh pengguna dan direkam di kolom user_defined_event_id log audit. @user_defined_event_id berjenis smallint.

[ @succeeded = ] succeeded
Parameter yang diteruskan oleh pengguna untuk menunjukkan apakah peristiwa berhasil atau tidak. Ini muncul di kolom yang berhasil dari log audit. @succeededadalah bit.

[ @user_defined_information = ] 'user_defined_information'
Adalah teks yang ditentukan oleh pengguna dan direkam di kolom user_defined_event_id baru log audit. @user_defined_information adalah nvarchar(4000).

Mengembalikan Nilai Kode

0 (keberhasilan) atau 1 (kegagalan)

Kegagalan disebabkan oleh parameter input yang salah atau kegagalan menulis ke log audit target.

Keterangan

Ketika USER_DEFINED_AUDIT_GROUP ditambahkan ke spesifikasi audit server atau spesifikasi audit database, peristiwa yang dipicu oleh sp_audit_write akan disertakan dalam log audit.

Izin

Memerlukan keanggotaan dalam peran database publik .

Contoh

A. Membuat peristiwa audit yang ditentukan pengguna dengan teks informasi

Contoh berikut membuat peristiwa audit dengan id 27, nilai berhasil 0, dan menyertakan teks informasi opsional.

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

B. Membuat peristiwa audit yang ditentukan pengguna tanpa teks informasi

Contoh berikut membuat peristiwa audit dengan id 27, nilai berhasil 0, dan tidak menyertakan teks informasi opsional atau nama parameter opsional.

EXEC sp_audit_write 27, 0;  
  

Lihat juga

Prosedur Tersimpan Keamanan (Transact-SQL)
sys.server_principals (T-SQL)
sp_addrole (Transact-SQL)
CREATE USER (Transact-SQL)
sp_dropuser (T-SQL)
sp_grantdbaccess (T-SQL)
sp_grantlogin (T-SQL)
Prosedur Tersimpan Sistem (Transact-SQL)