sp_audit_write(Transact-SQL)

적용 대상:SQL Server

사용자 정의 감사 이벤트를 USER_DEFINED_AUDIT_GROUP에 추가합니다. 사용하도록 설정 sp_audit_write 되지 않은 경우 USER_DEFINED_AUDIT_GROUP 무시됩니다.

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 작습니다.

[ @succeeded = ] 성공

이벤트가 성공했는지 여부를 나타내기 위해 사용자가 전달한 매개 변수입니다. 이 값은 succeeded 감사 로그의 열에 나타납니다. @succeeded 비트입니다.

[ @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. 정보 텍스트를 사용하여 사용자 정의 감사 이벤트 만들기

다음 예제에서는 값, 값 27@succeeded0@user_defined_event_id 선택적 정보 텍스트를 포함하는 감사 이벤트를 만듭니다.

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

B. 정보 텍스트 없이 사용자 정의 감사 이벤트 만들기

다음 예제에서는 값, @succeeded270, @user_defined_event_id 선택적 정보 텍스트 또는 선택적 매개 변수 이름을 포함하지 않는 감사 이벤트를 만듭니다.

EXEC sp_audit_write 27, 0;