sys.fn_trace_gettable(Transact-SQL)

적용 대상:SQL Server

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

Transact-SQL 구문 표기 규칙

구문

  
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_set상태(Transact-SQL)