sp_trace_setstatus(Transact-SQL)

적용 대상:SQL Server

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

중요

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

Transact-SQL 구문 규칙

구문

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

인수

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

[ @status = ] status 추적에서 구현할 작업을 지정합니다. 상태는int이며 기본값은 없습니다.

다음 표에서는 지정할 수 있는 상태를 보여 줍니다.

상태 Description
0 지정한 추적을 중지합니다.
1 지정한 추적을 시작합니다.
2 지정한 추적을 닫고 서버에서 해당 정의를 삭제합니다.

참고

추적은 먼저 중지한 후 닫아야 합니다. 추적은 먼저 중지하고 닫은 후에 확인할 수 있습니다.

반환 코드 값

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

반환 코드 설명
0 오류가 없습니다.
1 알 수 없는 오류입니다.
8 지정한 상태는 유효하지 않습니다.
9 지정한 추적 핸들이 유효하지 않습니다.
13 메모리가 부족합니다. 지정한 동작을 수행할 메모리가 충분하지 않으면 반환됩니다.

추적이 이미 지정된 상태에 있으면 SQL Server 0을 반환합니다.

설명

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

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

사용 권한

사용자는 ALTER TRACE 권한이 있어야 합니다.

관련 항목

sys.fn_trace_geteventinfo(Transact-SQL)
sys.fn_trace_getfilterinfo(Transact-SQL)
sp_trace_generateevent(Transact-SQL)
sp_trace_setevent(Transact-SQL)
sp_trace_setfilter(Transact-SQL)
SQL 추적