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를 사용하는 것이 좋습니다.

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

구문

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 권한이 필요합니다.

예

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

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

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

참고 항목

참조

확장 이벤트 동적 관리 뷰

확장 이벤트 카탈로그 뷰(Transact-SQL)

개념

확장 이벤트