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 데이터베이스 역할의 멤버여야 합니다.
예
1.정보 텍스트를 포함하여 사용자 정의 감사 이벤트 만들기
다음 예에서는 ID가 27인 감사 이벤트, succeeded 값 0, 그리고 선택적으로 포함되는 정보 텍스트를 작성합니다.
EXEC sp_audit_write @user_defined_event_id = 27 ,
@succeeded = 0
, @user_defined_information = N'Access to a monitored object.' ;
2.정보 텍스트 없이 사용자 정의 감사 이벤트 만들기
다음 예에서는 ID가 27인 감사 이벤트와 succeeded 값 0을 작성하되 선택적 정보 텍스트 또는 매개 변수 이름은 포함하지 않습니다.
EXEC sp_audit_write 27, 0;
참고 항목
참조
sys.server_principals(Transact-SQL)