sys.fn_MSxe_read_event_stream(Transact-SQL)

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

sys.fn_MSxe_read_event_stream 는 QueryableXEventData .NET 클래스에서 내부 사용을 위해 이진 데이터를 반환합니다. SSMS(SQL Server Management Studio)의 확장 이벤트 UI는 이 클래스를 사용하여 이벤트 세션 데이터를 읽습니다.

사람이 읽을 수 있는 이벤트 데이터를 보려면 직접 호출 sys.fn_MSxe_read_event_stream 하는 대신 다음 중 하나를 사용합니다.

• SSMS의 확장 이벤트 UI입니다.
• 테이블 반환 함수를 sys.fn_xe_file_target_read_file.

Transact-SQL 구문 표기 규칙

구문

sys.fn_MSxe_read_event_stream ( source , source_option )

인수

원본

함수에서 반환하는 이벤트 데이터의 특정 원본입니다. 원본 은 기본값이 없는 nvarchar(260) 입니다.

원본 은 source_option 값에 따라 다르게 해석됩니다.

source_option	원본 해석
0	원본 은 시작된 이벤트 세션의 이름입니다.
1	원본 은 읽을 이벤트 세션 로그 파일의 경로입니다. 로컬 파일 시스템의 파일과 함께 사용하는 경우 원본 은 이벤트 세션 로그 파일의 이름을 포함해야 하며 와일드카드로 포함할 * 수 있습니다. Azure Storage 컨테이너의 Blob과 함께 사용하는 경우 원본 은 두 부분으로 구성된 연결에 의해 생성된 HTTP URL입니다. 1. Azure Storage 스토리지 컨테이너에 대한 경로와 슬래시(/)가 뒤따릅니다. 2. 읽어야 하는 컨테이너의 Blob 이름에 대한 일반적인 접두사입니다. 예를 들어 https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session으로 사용하면 확장을 포함한 Blob 이름의 나머지 부분과 관계없이 이름이 로 시작하는 xe_session모든 Blob에서 데이터를 검색합니다. 와일드카드를 지정할 수 없습니다. Azure Storage 컨테이너에 대한 액세스를 허용하는 자격 증명이 있어야 합니다.

source_option

이벤트 데이터 원본의 형식을 결정하는 옵션입니다. 가능한 값은 다음과 같습니다.

가치	설명
0	시작된 이벤트 세션의 event_stream 대상에서 이벤트 데이터를 반환합니다. 함수는 무기한 실행되며 세션이 생성할 때 새 이벤트 데이터를 반환합니다.
1	원본에서 지정한 확장 이벤트 로그 파일에서 이벤트 데이터를 반환합니다.

반환된 테이블

열 이름	데이터 형식	설명
type	int	이벤트 유형입니다. Null을 허용하지 않습니다.
데이터	image	이진 이벤트 데이터입니다. Null을 허용합니다.

관련 콘텐츠

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