sys.fn_xe_file_target_read_file(Transact-SQL)

적용 대상: 예SQL Server(지원되는 모든 버전) 예Azure SQL Database

확장 이벤트 비동기 파일 대상에서 만든 파일을 읽습니다. 행당 하나의 이벤트가 XML 형식으로 반환됩니다.

경고

SQL Server 2008SQL Server 2008 R2XEL 및 XEM 형식으로 생성 된 추적 결과를 허용 합니다. SQL Server 2012(11.x) 확장 이벤트는 XEL 형식의 추적 결과만 지원 합니다. XEL 형식의 추적 결과를 읽으려면 SQL Server Management Studio를 사용하는 것이 좋습니다.

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

구문

  
sys.fn_xe_file_target_read_file ( path, mdpath, initial_file_name, initial_offset )  

인수

path
읽을 파일 파일의 경로입니다. 경로 에는 와일드 카드를 포함할 수 있으며 파일 이름을 포함할 수 있습니다. 경로nvarchar (260) 입니다. 기본값은 없습니다. Azure SQL Database 컨텍스트에서이 값은 Azure Storage 파일에 대 한 HTTP URL입니다.

mdpath
Path 인수로 지정 된 파일에 해당 하는 메타 데이터 파일의 경로입니다. mdpathnvarchar (260) 입니다. 기본값은 없습니다. SQL Server 2016부터이 매개 변수는 null로 지정할 수 있습니다.

참고

SQL Server 2012(11.x) 에는 mdpath 매개 변수가 필요 하지 않습니다. 그러나 이전 버전의 SQL Server에서 생성된 로그 파일의 경우 이전 버전과의 호환성을 위해 이 매개 변수가 유지됩니다.

initial_file_name
경로 에서 읽을 첫 번째 파일입니다. initial_file_namenvarchar (260) 입니다. 기본값은 없습니다. Null 이 인수로 지정 된 경우 경로 에 있는 모든 파일을 읽습니다.

참고

initial_file_nameinitial_offset 는 쌍을 이루는 인수입니다. 둘 중 한 인수의 값을 지정하는 경우 다른 한 인수의 값도 지정해야 합니다.

initial_offset
이전에 읽은 마지막 오프셋을 지정하는데 사용되고 오프셋(포함)까지 모든 이벤트를 건너뜁니다. 이벤트 열거는 오프셋이 지정된 후에 시작됩니다. initial_offsetbigint 입니다. Null 을 인수로 지정 하면 전체 파일을 읽을 수 있습니다.

반환된 테이블

열 이름 데이터 형식 Description
module_guid uniqueidentifier 이벤트 모듈 GUID입니다. Null을 허용하지 않습니다.
package_guid uniqueidentifier 이벤트 패키지 GUID입니다. Null을 허용하지 않습니다.
object_name nvarchar(256) 이벤트의 이름입니다. Null을 허용하지 않습니다.
event_data nvarchar(max) XML 형식의 이벤트 내용입니다. Null을 허용하지 않습니다.
file_name nvarchar(260) 이벤트가 포함된 파일의 이름입니다. Null을 허용하지 않습니다.
file_offset bigint 이벤트가 포함된 파일에 있는 블록의 오프셋입니다. Null을 허용하지 않습니다.
timestamp_utc datetime2 적용 대상: SQL Server 2017(14.x) 이상 및 Azure SQL Database

이벤트의 날짜 및 시간 (UTC 표준 시간대)입니다. Null을 허용하지 않습니다.

설명

에서 sys.fn_xe_file_target_read_file 를 실행 하 여 많은 결과 집합을 읽으면 Management Studio 오류가 발생할 수 있습니다. 결과 파일 모드 (Ctrl + Shift + F)를 사용 하 여 많은 결과 집합을 파일로 내보내고 대신 다른 도구를 사용 하 여 파일을 읽습니다.

사용 권한

을 실행하려면 서버에 대해 VIEW SERVER STATE 권한이 필요합니다.

예제

A. 파일 대상에서 데이터 가져오기

다음 예에서는 모든 파일의 행을 모두 가져옵니다. 이 예에서 파일 대상과 메타파일은 C:\ 드라이브의 추적 폴더에 있습니다.

SELECT * FROM sys.fn_xe_file_target_read_file('C:\traces\*.xel', 'C:\traces\metafile.xem', null, null);  

참고 항목

확장 이벤트 동적 관리 뷰
확장 이벤트 카탈로그 뷰(Transact-SQL)
확장 이벤트