sys.fn_xe_file_target_read_file(Transact-SQL)
확장 이벤트 비동기 파일 대상에서 만든 파일을 읽습니다. 행당 하나의 이벤트가 XML 형식으로 반환됩니다.
구문
sys.fn_xe_file_target_read_file ( path, mdpath, initial_file_name, initial_offset )
인수
path
읽을 파일의 경로입니다. path에는 와일드카드와 파일 이름이 포함될 수 있습니다. path는 nvarchar(260)입니다. 기본값은 없습니다.mdpath
path 인수로 지정한 파일에 해당하는 메타데이터 파일의 경로입니다. mdpath는 nvarchar(260)입니다. 기본값은 없습니다.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 권한이 필요합니다.
예
1. 파일 대상에서 데이터 가져오기
다음 예에서는 모든 파일의 행을 모두 가져옵니다. 이 예에서 파일 대상과 메타파일은 C:\ 드라이브의 추적 폴더에 있습니다.
select * from sys.fn_xe_file_target_read_file('C:\traces\*.xel', 'C:\traces\metafile.xem', null, null)