sp_trace_setstatus(Transact-SQL)

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

중요 정보중요

Microsoft SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 응용 프로그램은 수정하십시오. 확장 이벤트를 대신 사용하십시오.

항목 링크 아이콘 Transact-SQL 구문 표기 규칙

구문

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

인수

  • [ @traceid= ] trace_id
    수정할 추적의 ID입니다. trace_id는 int이며 기본값은 없습니다. 사용자는 이 trace_id 값을 사용하여 추적을 식별, 수정 및 제어할 수 있습니다. trace_id를 검색하는 방법은 sys.fn_trace_getinfo (Transact-SQL)를 참조하십시오.

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

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

    상태

    설명

    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 추적