分享方式：

sp_audit_write （Transact-SQL）

  • 文章

適用於：SQL Server

將使用者定義的稽核事件新增至 USER_DEFINED_AUDIT_GROUP。 如果未 USER_DEFINED_AUDIT_GROUP 啟用， sp_audit_write 則會忽略 。

Transact-SQL 語法慣例

語法

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

引數

[ @user_defined_event_id = ] user_defined_event_id

使用者所定義的參數，並記錄在 user_defined_event_id 稽核記錄的數據行中。 @user_defined_event_id為smallint。

[ @succeeded = ] 成功

用戶傳遞的參數，指出事件是否成功。 此值會出現在 succeeded 稽核記錄的數據行中。 @succeeded為 bit。

[ @user_defined_information = ] N'user_defined_information'

使用者所定義的文字，並記錄在稽核記錄的新 user_defined_event_id 數據行中。 @user_defined_information是 nvarchar（4000）。

傳回碼值

0 (成功) 或 1 (失敗)。

失敗是由不正確的輸入參數所造成，或無法寫入目標稽核記錄檔。

備註

USER_DEFINED_AUDIT_GROUP將 新增至伺服器稽核規格或資料庫稽核規格時，所sp_audit_write觸發的事件會包含在稽核記錄中。

權限

需要公用資料庫角色的成員資格。

範例

A. 使用參考文字建立用戶定義的稽核事件

下列範例會建立稽核事件，其 @user_defined_event_id 值為 27、 @succeeded 的值 0，並包含選擇性的資訊文字。

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

B. 建立不含參考文字的用戶定義稽核事件

下列範例會建立稽核事件，其@user_defined_event_id值為 27、@succeeded0的值，且不包含選擇性的資訊文字或選擇性參數名稱。

EXEC sp_audit_write 27, 0;

相關內容