sys.fn_xe_file_target_read_file(Transact-SQL)

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

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

구문

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

path
읽을 파일 파일의 경로입니다. path에는 와일드카드와 파일 이름이 포함될 수 있습니다. path는 nvarchar(260)입니다. 기본값은 없습니다.
mdpath
path 인수로 지정한 파일에 해당하는 메타데이터 파일의 경로입니다. mdpath는 nvarchar(260)입니다. 기본값은 없습니다.

[!참고]

SQL Server 2012에는 mdpath 매개 변수가 필요하지 않습니다. 그러나 이전 버전의 SQL Server에서 생성된 로그 파일의 경우 이전 버전과의 호환성을 위해 이 매개 변수가 유지됩니다.
initial_file_name
path에서 읽을 첫 번째 파일입니다. initial_file_name은 nvarchar(260)입니다. 기본값은 없습니다. null을 인수로 지정하면 path에 있는 모든 파일을 읽습니다.

[!참고]

initial_file_name과 initial_offset은 쌍을 이루는 인수입니다. 둘 중 한 인수의 값을 지정하는 경우 다른 한 인수의 값도 지정해야 합니다.
initial_offset
이전에 읽은 마지막 오프셋을 지정하는데 사용되고 오프셋(포함)까지 모든 이벤트를 건너뜁니다. 이벤트 열거는 오프셋이 지정된 후에 시작됩니다. initial_offset은 bigint입니다. null을 인수로 지정하면 전체 파일을 읽습니다.

열 이름	데이터 형식	설명
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을 허용하지 않습니다.

서버에 대한 VIEW SERVER STATE 권한이 필요합니다.

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

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