Compartir por


sys.fn_MSxe_read_event_stream (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

sys.fn_MSxe_read_event_stream devuelve datos binarios para uso interno de la clase QueryableXEventData .NET. La interfaz de usuario de eventos extendidos de SQL Server Management Studio (SSMS) usa esta clase para leer los datos de la sesión de eventos.

Para ver los datos de eventos legibles, use uno de los siguientes en lugar de llamar sys.fn_MSxe_read_event_stream directamente:

Convenciones de sintaxis de Transact-SQL

Sintaxis

sys.fn_MSxe_read_event_stream ( source , source_option )

Argumentos

de origen

Origen específico de los datos de evento devueltos por la función . El origen es nvarchar(260) sin valor predeterminado.

El origen se interpreta de forma diferente en función del valor de source_option:

source_option Interpretación del origen
0 Source es el nombre de una sesión de eventos iniciada.
1 Source es la ruta de acceso a los archivos de registro de sesión de eventos que se van a leer.

Cuando se usa con archivos en el sistema de archivos local, el origen debe incluir el nombre de un archivo de registro de sesión de eventos y puede contener * como carácter comodín.

Cuando se usa con blobs en un contenedor de Azure Storage, el origen es una dirección URL HTTP construida por la concatenación de dos partes:

1. Ruta de acceso a un contenedor de almacenamiento de Azure Storage, seguido de una barra diagonal (/).
2. Prefijo común para los nombres de blobs en el contenedor que se deben leer.

Por ejemplo, el uso https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session de como origen recupera datos de todos los blobs con nombres a partir xe_sessionde y, independientemente del resto del nombre del blob, incluida la extensión. No se pueden especificar caracteres comodín. Debe existir una credencial que permita el acceso al contenedor de Azure Storage.

source_option

Opción que determina el tipo del origen de datos del evento. Los valores posibles son:

Importancia Descripción
0 Devuelve datos de eventos del event_stream destino de una sesión de eventos iniciada. La función se ejecuta indefinidamente y devuelve datos de eventos nuevos a medida que la sesión la genera.
1 Devuelve datos de eventos de los archivos de registro de eventos extendidos especificados por el origen.

Tabla devuelta

Nombre de la columna Tipo de datos Descripción
type Int El tipo de evento. No acepta valores NULL.
data image Datos de eventos binarios. Acepta valores NULL.