NSEventBatchDetails (Transact-SQL)

Artículo
12/15/2008

Devuelve información detallada acerca de un lote de eventos en una aplicación de Microsoft SQL Server Notification Services. Un conjunto de resultados contiene información general sobre el lote de eventos, como el nombre del proveedor de eventos y el momento en que se recopiló el lote de eventos. Un segundo conjunto de resultados muestra los eventos enviados en el lote.

Sintaxis

[ application_schema_name . ] NSEventBatchDetails 
    [ @EventClassName = ] 'event_class_name' ,
    [ @EventBatchId = ] event_batch_id

Argumentos

[ @EventClassName = ] 'event_class_name'
Nombre de una clase de evento. event_class_name es de tipo nvarchar(255) y no tiene ningún valor predeterminado.

[ @EventBatchId = ] event_batch_id
Identificador único de un lote de eventos. event_batch_id es de tipo bigint y no tiene ningún valor predeterminado.

Conjuntos de resultados

NSEventBatchDetails genera dos conjuntos de resultados. El primer conjunto de resultados contiene información general acerca del lote de eventos.

Nombre de columna	Tipo de datos	Descripción
ProviderName	nvarchar(255)	Nombre del proveedor de eventos que ha enviado el lote de eventos. Este valor es NULL si los eventos se insertaron directamente en la vista <EventClassName>.
EventCount	bigint	Número de eventos del lote de eventos.
StartCollectionTime	datetime	Fecha y hora en que comenzó la recopilación del lote de eventos, expresada en UTC (hora universal coordinada u hora del meridiano de Greenwich).
EndCollectionTime	datetime	Fecha y hora (en UTC) en que finalizó la recopilación del lote de eventos.
CollectionTimeInMS	int	Tiempo total, en milisegundos, para recopilar el lote de eventos.

El segundo conjunto de resultados contiene los detalles de los eventos enviados en el lote de eventos, ordenados por la columna EventId.

Nombre de columna	Tipo de datos	Descripción
EventId	bigint	Número de Id. utilizado para identificar un evento.
Event_class_field_name	definido por la aplicación	Nombre de un campo de clase de evento, tal como se define en el archivo de definición de aplicación (ADF). Cada campo de la clase de evento está representado por una columna en el conjunto de resultados.

Notas

Notification Services crea el procedimiento almacenado NSEventBatchDetails en la base de datos de aplicación al crear la instancia. Al actualizar la aplicación, Notification Services vuelve a compilar el procedimiento almacenado.

Este procedimiento almacenado se encuentra en el esquema de la aplicación, que se especifica mediante el elemento SchemaName del archivo de definición de aplicación (ADF). Si no se proporciona ningún nombre de esquema, el esquema predeterminado es dbo.

Permisos

De forma predeterminada, los permisos de ejecución corresponden a los miembros de la función de base de datos NSAnalysis, la función fija de base de datos db_owner y la función fija de servidor sysadmin.

Valores de código de retorno

Ninguno

Ejemplos

A. Con el esquema de aplicación predeterminado

En el ejemplo siguiente se muestra cómo generar el informe de detalles del lote de eventos. La aplicación utiliza la configuración predeterminada de SchemaName, que coloca todos los objetos de la aplicación en el esquema dbo.

El informe contiene dos conjuntos de resultados. El primero muestra el proveedor de eventos e información sobre la recopilación de eventos para el lote de eventos; el segundo muestra los eventos enviados en el lote de eventos.

EXEC dbo.NSEventBatchDetails 
    @EventClassName = N'StockEvents',
    @EventBatchId = 1;

B. Con un esquema de aplicación con nombre

En el ejemplo siguiente se muestra cómo generar el informe del lote de eventos cuando el procedimiento almacenado (como los demás objetos de la aplicación) se encuentra en el esquema Stock, tal como se especifica en el elemento SchemaName del ADF.

EXEC Stock.NSEventBatchDetails 
    @EventClassName = N'StockEvents',
    @EventBatchId = 1;

Vea también

Share via