sp_trace_setstatus(Transact-SQL)
적용 대상: SQL Server
지정된 추적의 현재 상태를 수정합니다.
Important
SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. 대신 확장 이벤트를 사용합니다.
구문
sp_trace_setstatus
[ @traceid = ] traceid
, [ @status = ] status
[ ; ]
인수
[ @traceid = ] traceid
수정할 추적의 ID입니다. @traceid 기본값이 없는 int입니다. 사용자는 이 @traceid 값을 사용하여 추적을 식별, 수정 및 제어합니다. @traceid 검색하는 방법에 대한 자세한 내용은 sys.fn_trace_getinfo(Transact-SQL)를 참조하세요.
[ @status = ] status
추적에 구현할 작업을 지정합니다. @status 기본값이 없는 int입니다.
다음 표에서는 지정할 수 있는 상태를 나열합니다.
Status | 설명 |
---|---|
0 |
지정한 추적을 중지합니다. |
1 |
지정된 추적을 시작합니다. |
2 |
지정된 추적을 닫고 서버에서 해당 정의를 삭제합니다. |
참고 항목
추적은 먼저 중지한 후 닫아야 합니다. 추적을 보려면 먼저 중지하고 닫아야 합니다.
반환 코드 값
다음 표에서는 저장 프로시저가 완료된 후 사용자가 얻을 수 있는 코드 값에 대해 설명합니다.
반환 코드 | 설명 |
---|---|
0 |
오류가 없습니다. |
1 |
알 수 없는 오류입니다. |
8 |
지정한 상태가 잘못되었습니다. |
9 |
지정한 추적 핸들이 잘못되었습니다. |
13 |
메모리가 부족합니다. 메모리가 부족하여 지정된 작업을 수행할 수 없을 때 반환됩니다. |
추적이 이미 지정된 상태이면 SQL Server가 반환됩니다 0
.
설명
모든 SQL 추적 저장 프로시저(sp_trace_*
)의 매개 변수는 엄격하게 입력됩니다. 인수 설명에 지정된 대로 올바른 입력 매개 변수 데이터 형식으로 이러한 매개 변수를 호출하지 않으면 저장 프로시저에서 오류를 반환합니다.
추적 저장 프로시저를 사용하는 예제는 추적 만들기(Transact-SQL)를 참조하세요.
사용 권한
ALTER TRACE 권한이 필요합니다.