sp_trace_setstatus(Transact-SQL)

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

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

구문

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 권한이 있어야 합니다.