sys.fn_trace_gettable(Transact-SQL)
적용 대상: 
SQL Server
하나 이상의 추적 파일의 내용을 테이블 형식으로 반환합니다.
Important
SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. 대신 확장 이벤트를 사용합니다.
구문
fn_trace_gettable ( 'filename' , number_files )
인수
'filename'
읽을 초기 추적 파일을 지정합니다. filename 은 nvarchar(256)이며 기본값은 없습니다.
number_files
읽을 롤오버 파일의 수를 지정합니다. 이 번호에는 파일 이름에 지정된 초기 파일이 포함됩니다. number_files int입니다.
설명
number_files 기본값으로 지정된 경우 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 권한이 필요합니다.
예제
A. fn_trace_gettable 사용하여 추적 파일에서 행 가져오기
다음 예에서는 fn_trace_gettable 문의 FROM 절에서 SELECT...INTO을 호출합니다.
USE AdventureWorks2022;
GO
SELECT * INTO temp_trc
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);
GO
B. fn_trace_gettable 사용하여 SQL Server 테이블에 로드할 수 있는 IDENTITY 열이 있는 테이블 반환
다음은 SELECT...INTO 문의 일부로 함수를 호출하고 IDENTITY 테이블로 로드할 수 있는 temp_trc 열이 있는 테이블을 반환하는 예입니다.
USE AdventureWorks2022;
GO
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);
GO
참고 항목
sp_trace_generateevent(Transact-SQL)
sp_trace_setevent(Transact-SQL)
sp_trace_setfilter(Transact-SQL)
sp_trace_setstatus(Transact-SQL)