NSNotificationBatchDetails (Transact-SQL)

Artículo
12/15/2008

Actualizado: 14 de abril de 2006

Genera el informe detallado del lote de notificaciones para una aplicación de Microsoft SQL Server Notification Services. Este informe contiene información sobre un lote de notificaciones específico, como la activación de reglas que generó el lote y las notificaciones incluidas en el mismo. Use este procedimiento almacenado para solucionar problemas relacionados con la generación de notificaciones y para analizar el progreso de las notificaciones en la aplicación.

Sintaxis

[ application_schema_name . ] NSNotificationBatchDetails 
    [ @NotificationClassName = ] 'notification_class_name',
    [ @NotificationBatchId = ] notification_batch_id

Argumentos

[ @NotificationClassName = ] 'notification_class_name'
Es el nombre de una clase de notificación. notification_class_name es de tipo nvarchar(255) y no tiene ningún valor predeterminado.

[ @NotificationBatchId = ] notification_batch_id
Es el identificador único utilizado para identificar un lote de notificaciones. notification_batch_id es de tipo bigint y no tiene ningún valor predeterminado.

Conjuntos de resultados

NSNotificationBatchDetails genera tres conjuntos de resultados. El primer conjunto de resultados proporciona información general acerca del lote de notificaciones.

Nombre de columna	Tipo de datos	Descripción
RuleFiringId	int	Id. único de la activación de regla que ha generado el lote de notificaciones.
StartGenerationTime	datetime	Fecha y hora de inicio de la generación del lote de notificaciones, en UTC (hora universal coordinada u hora del meridiano de Greenwich).
EndGenerationTime	datetime	Fecha y hora UTC en que finalizó la generación del lote de notificaciones.
GenerationTimeInMS	int	Período de tiempo, en milisegundos, que tardó en finalizar la generación del lote de notificaciones.
NotificationBatchExpirationTime	datetime	Fecha y hora UTC en que caduca el lote de notificaciones. Después de la fecha de vencimiento, se abandonan las notificaciones que queden sin entregar. No se intentará volver a entregar estas notificaciones, independientemente de los reintentos programados. Si este valor es NULL, el lote no tiene fecha de vencimiento.
NotificationCount	int	Número de notificaciones del lote de notificaciones.
StatusDescription	nvarchar(255)	Estado actual del lote de notificaciones.

El segundo conjunto de resultados proporciona información sobre cómo se han distribuido las notificaciones del lote entre los canales de entrega de la instancia.

Nombre de columna	Tipo de datos	Descripción
DeliveryChannelName	nvarchar(255)	Nombre del canal de entrega.
LastDistributionStartTime	datetime	Última vez que el distribuidor comenzó a entregar notificaciones de este lote por medio de este canal de entrega.
NotificationsWithNoDeliveryAttempt	int	Número de notificaciones de este lote que el distribuidor todavía tiene que entregar por medio de este canal de entrega.
NotificationsSuccessfullyDelivered	int	Número de notificaciones de este lote que se han entregado correctamente por medio de este canal de entrega.
NotificationsFailedToDeliver	int	Número de notificaciones de este lote que no se han podido entregar para este canal de entrega.
RetryCount	int	Número de veces que el distribuidor ha recogido el lote de notificaciones para la entrega por medio de este canal de entrega.
NextRetryTime	datetime	Próxima vez que el distribuidor intentará entregar notificaciones de este lote por medio de este canal de entrega.

El tercer conjunto de resultados proporciona información detallada acerca de las notificaciones del lote de notificaciones.

Nombre de columna	Tipo de datos	Descripción
NotificationId	bigint	Id. de la notificación en el lote de notificaciones.
SubscriberId	nvarchar(255)	Id. del suscriptor de la notificación.
DeviceName	nvarchar(255)	Nombre del dispositivo de suscriptor de la notificación.
SubscriberLocale	nvarchar(10)	Nombre de la configuración regional de la notificación.
DeliveryStatus	nvarchar(255)	Descripción del estado de entrega actual de la notificación.
SentTime	datetime	Fecha y hora UTC de la última vez que se realizó correctamente un intento de entrega de la notificación. Si este valor es NULL, no se ha intentado entregar la notificación o la entrega todavía no ha finalizado.
LinkedParentNotification	bigint	Id. de notificación inicial del grupo de entrega de resumen o de multidifusión, si la notificación se ha enviado en un mensaje de entrega de resumen o de multidifusión.
DeliveryChannel	nvarchar(255)	Nombre del canal de entrega que envió la notificación.
DeliveryAttempts	int	Número de intentos de entrega de la notificación.
Notification_class_field_name	Definido por la aplicación	Nombre de un campo de clase de notificación, tal como se define en el archivo de definición de aplicación (ADF). Cada campo de la clase de notificación está representado por una columna en el conjunto de resultados.

Notas

Notification Services crea el procedimiento almacenado NSNotificationBatchDetails 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

En este ejemplo se generan los tres conjuntos de resultados que se han mencionado en esta sección para el lote de notificaciones 1 de la clase de notificación StockNotifications:

La aplicación utiliza la configuración predeterminada de SchemaName, que coloca todos los objetos de la aplicación en el esquema dbo.

EXEC dbo.NSNotificationBatchDetails 
    @NotificationClassName = N'StockNotifications', 
    @NotificationBatchId = 1;

Vea también

Historial de cambios

Versión	Historial
14 de abril de 2006	Contenido modificado: Se han corregido las descripciones de las columnas en el segundo conjunto de resultados.

Share via