fn_trace_gettable(Transact-SQL)

하나 이상의 추적 파일의 내용을 테이블 형식으로 반환합니다.

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

구문

fn_trace_gettable ( 'filename' , number_files )

인수

  • 'filename'
    읽을 초기 추적 파일을 지정합니다. filename은 nvarchar(256)이며 기본값은 없습니다.

  • number_files
    읽을 롤오버 파일의 수를 지정합니다. 이 숫자에는 filename에 지정된 초기 파일이 포함됩니다. number_files는 int입니다.

주의

number_files가 default로 지정된 경우 fn_trace_gettable은 추적 끝에 도달할 때까지 모든 롤오버 파일을 읽습니다. fn_trace_gettable은 지정된 추적에 대해 유효한 모든 열이 있는 테이블을 반환합니다. 자세한 내용은 sp_trace_setevent(Transact-SQL)를 참조하십시오.

fn_trace_gettable 함수는 원래 추적 파일 이름이 밑줄과 숫자 값으로 끝나는 롤오버 파일을 로드하지 않습니다(number_files 인수를 사용하여 이 옵션이 지정된 경우). 이는 파일이 롤오버될 때 자동으로 추가된 밑줄과 숫자에는 적용되지 않습니다. 추적 파일의 이름을 변경하여 원래 파일 이름에서 밑줄을 제거하면 이 문제를 해결할 수 있습니다. 예를 들어 원래 파일 이름이 Trace_Oct_5.trc이고 롤오버 파일 이름이 Trace_Oct_5_1.trc인 경우 파일 이름을 TraceOct5.trc 및 TraceOct5_1.trc로 변경할 수 있습니다.

이 함수는 실행된 인스턴스에서 아직 활성 상태인 추적을 읽을 수 있습니다.

사용 권한

서버에 대한 ALTER TRACE 권한이 필요합니다.

1. fn_trace_gettable을 사용하여 추적 파일에서 행 가져오기

다음 예에서는 SELECT...INTO 문의 FROM 절에서 fn_trace_gettable을 호출합니다.

USE AdventureWorks;
GO
SELECT * INTO temp_trc
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);
GO

2. fn_trace_gettable을 사용하여 SQL Server 테이블로 로드할 수 있는 IDENTITY 열이 있는 테이블 반환

다음은 SELECT...INTO 문의 일부로 함수를 호출하고 temp_trc 테이블로 로드할 수 있는 IDENTITY 열이 있는 테이블을 반환하는 예입니다.

USE AdventureWorks;
GO
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);
GO

변경 내역

업데이트된 내용

주의 섹션에서 원래 추적 파일 이름이 밑줄과 숫자 값으로 끝나는 경우의 롤오버 파일 동작에 대한 정보를 업데이트했습니다.