sp_trace_set상태(Transact-SQL)

  • 아티클

적용 대상:SQL Server

지정된 추적의 현재 상태를 수정합니다.

Important

이 기능은 이후 버전의 SQL Server에서 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. 대신 확장 이벤트를 사용합니다.

Transact-SQL 구문 표기 규칙

구문

sp_trace_setstatus
    [ @traceid = ] traceid
    , [ @status = ] status
[ ; ]

인수

[ @traceid = ] traceid

수정할 추적의 ID입니다. @traceid 기본값이 없는 int입니다. 사용자는 이 @traceid 값을 사용하여 추적을 식별, 수정 및 제어합니다. @traceid 검색하는 방법에 대한 자세한 내용은 sys.fn_trace_getinfo(Transact-SQL)를 참조하세요.

[ @status = ] 상태

추적에 구현할 작업을 지정합니다. @상태 기본값이 없는 int입니다.

다음 표에서는 지정할 수 있는 상태 나열합니다.

Status 설명
0 지정한 추적을 중지합니다.
1 지정된 추적을 시작합니다.
2 지정된 추적을 닫고 서버에서 해당 정의를 삭제합니다.

참고 항목

추적은 먼저 중지한 후 닫아야 합니다. 추적을 보려면 먼저 중지하고 닫아야 합니다.

반환 코드 값

다음 표에서는 저장 프로시저가 완료된 후 사용자가 얻을 수 있는 코드 값에 대해 설명합니다.

반환 코드 설명
0 오류가 없습니다.
1 알 수 없는 오류입니다.
8 지정한 상태가 잘못되었습니다.
9 지정한 추적 핸들이 잘못되었습니다.
13 메모리가 부족합니다. 메모리가 부족하여 지정된 작업을 수행할 수 없을 때 반환됩니다.

추적이 이미 지정된 상태이면 SQL Server가 반환됩니다 0.

설명

모든 SQL 추적 저장 프로시저(sp_trace_*)의 매개 변수는 엄격하게 입력됩니다. 인수 설명에 지정된 대로 올바른 입력 매개 변수 데이터 형식으로 이러한 매개 변수를 호출하지 않으면 저장 프로시저에서 오류를 반환합니다.

추적 저장 프로시저를 사용하는 예제는 추적 만들기(Transact-SQL)를 참조하세요.

사용 권한

ALTER TRACE 권한이 필요합니다.

관련 콘텐츠