sp_audit_write (Transact-SQL)
將使用者定義稽核事件加入至 USER_DEFINED_AUDIT_GROUP。 如果沒有啟用 USER_DEFINED_AUDIT_GROUP，就會忽略 sp_audit_write。
.gif "主題連結圖示")
語法
sp_audit_write [ @user_defined_event_id = ] user_defined_event_id ,
[ @succeeded = succeeded
[ , [ @user_defined_information = ] 'user_defined_information' ]
[ ; ]
引數
@user_defined_event_id
由使用者定義並且記錄在稽核記錄之 user_defined_event_id 資料行中的參數。 @user\_defined\_event\_id 的類型是 smallint。@succeeded
由使用者傳遞的參數，指出事件是否成功。 這會顯示在稽核記錄的 succeeded 資料行中。 @succeeded 是 bit。@user_defined_information
由使用者定義並且記錄在稽核記錄之新 user_defined_event_id 資料行中的文字。 @user\_defined\_information 是 nvarchar(4000)。
傳回碼值
0 (成功) 或 1 (失敗)
輸入參數錯誤或無法寫入目標稽核記錄都會造成失敗。
備註
將 USER_DEFINED_AUDIT_GROUP 加入至伺服器稽核規格或資料庫稽核規格時，稽核記錄就會包含 sp_audit_write 所觸發的事件。
權限
需要 public 資料庫角色中的成員資格。
範例
A.建立包含資訊文字的使用者定義稽核事件
下列範例會建立識別碼為 27、succeeded 值為 0 而且包含選擇性參考用文字的稽核事件。
EXEC sp_audit_write @user_defined_event_id = 27 ,
@succeeded = 0
, @user_defined_information = N'Access to a monitored object.' ;
B.建立不包含資訊文字的使用者定義稽核事件
下列範例會建立識別碼為 27、succeeded 值為 0 而且不包含選擇性參考用文字或選擇性參數名稱的稽核事件。
EXEC sp_audit_write 27, 0;
請參閱
參考
sys.server_principals (Transact-SQL)