sp_trace_setstatus(Transact-SQL)

적용 대상: SQL Server

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

Important

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

구문

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

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

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

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

참고 항목

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

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

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

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

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

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

ALTER TRACE 권한이 필요합니다.