sp_trace_setstatus(Transact-SQL)
지정한 추적의 현재 상태를 수정합니다.
.gif "항목 링크 아이콘")
구문
sp_trace_setstatus [ @traceid = ] trace_id , [ @status = ] status
인수
[ @traceid= ] trace_id
수정할 추적의 ID입니다. trace_id는 int이며 기본값은 없습니다. 사용자는 이 trace_id 값을 사용하여 추적을 식별, 수정 및 제어할 수 있습니다. trace_id를 검색하는 방법은 fn_trace_getinfo(Transact-SQL)를 참조하십시오.[ @status= ] status
추적에서 구현할 동작을 지정합니다. status는 int이며 기본값은 없습니다.다음 표에서는 지정할 수 있는 상태를 보여 줍니다.
상태
설명
0
지정한 추적을 중지합니다.
1
지정한 추적을 시작합니다.
2
지정한 추적을 닫고 서버에서 해당 정의를 삭제합니다.
[!참고]
추적은 먼저 중지한 후 닫아야 합니다. 추적은 먼저 중지하고 닫은 후에 확인할 수 있습니다.
반환 코드 값
다음 표에서는 저장 프로시저가 완료된 후 사용자가 얻을 수 있는 코드 값을 설명합니다.
반환 코드 |
설명 |
|---|---|
0 |
오류가 없습니다. |
1 |
알 수 없는 오류입니다. |
8 |
지정한 상태는 유효하지 않습니다. |
9 |
지정한 추적 핸들이 유효하지 않습니다. |
13 |
메모리가 부족합니다. 지정한 동작을 수행할 메모리가 충분하지 않으면 반환됩니다. |
추적이 이미 지정한 상태에 있으면 SQL Server는 0을 반환합니다.
주의
모든 SQL Trace 저장 프로시저(sp_trace_xx)의 매개 변수는 유형 지정이 엄격합니다. 이러한 매개 변수가 정확한 입력 매개 변수 데이터 형식으로 호출되지 않으면 인수 설명에서 지정한 대로 저장 프로시저는 오류를 반환합니다.
추적 저장 프로시저 사용에 대한 예는 방법: 추적 만들기(Transact-SQL)를 참조하십시오.
사용 권한
사용자는 ALTER TRACE 권한이 있어야 합니다.