Bagikan melalui

sp_audit_write (T-SQL)

  • Artikel

Berlaku untuk: SQL Server

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

Konvensi sintaks transact-SQL

Sintaks

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

Argumen

[ @user_defined_event_id = ] user_defined_event_id

Parameter yang ditentukan oleh pengguna dan direkam di user_defined_event_id kolom log audit. @user_defined_event_id kecil.

[ @succeeded = ] berhasil

Parameter yang diteruskan oleh pengguna untuk menunjukkan apakah peristiwa berhasil atau tidak. Nilai ini muncul di succeeded kolom log audit. @succeeded sedikit.

[ @user_defined_information = ] N'user_defined_information'

Teks yang ditentukan oleh pengguna dan direkam di kolom baru user_defined_event_id log audit. @user_defined_information adalah nvarchar(4000).

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

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

Keterangan

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

Izin

Memerlukan keanggotaan dalam peran database publik .

Contoh

J. Membuat peristiwa audit yang ditentukan pengguna dengan teks informasi

Contoh berikut membuat peristiwa audit dengan @user_defined_event_id nilai 27, @succeeded nilai 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 @user_defined_event_id nilai 27, @succeeded nilai 0, dan tidak menyertakan teks informasi opsional atau nama parameter opsional.

EXEC sp_audit_write 27, 0;

Konten terkait