NSNotificationBatchDetails (Transact-SQL)

Article
12/15/2008

Mis à jour : 14 avril 2006

Génère le rapport des détails d'un lot de notifications pour une application Microsoft SQL Server Notification Services. Ce rapport contient des informations sur un lot de notifications spécifique, dont l'activation de règle qui a généré le lot et les notifications contenues dans le lot. Utilisez cette procédure stockée pour résoudre les problèmes de création des notifications et analyser la progression des notifications dans l'application.

Syntaxe

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

Arguments

[ @NotificationClassName = ] 'notification_class_name'
Nom d'une classe de notification. notification_class_name est de type nvarchar(255) et n'a pas de valeur par défaut.

[ @NotificationBatchId = ] notification_batch_id
Identificateur unique utilisé pour identifier un lot de notifications. notification_batch_id est de type bigint et n'a pas de valeur par défaut.

Notes

Notification Services crée la procédure stockée NSNotificationBatchDetails dans la base de données de l'application lorsque vous créez l'instance. Lorsque vous mettez à jour l'application, Notification Services recompile la procédure stockée.

Cette procédure stockée se trouve dans le schéma de l'application, qui est spécifié par l'élément SchemaName du fichier de définition de l'application. Si aucun nom de schéma n'est spécifié, le schéma par défaut est dbo.

Autorisations

Les autorisations d'exécution sont octroyées par défaut aux membres du rôle de base de données NSAnalysis, du rôle de base de données fixe db_owner et du rôle de serveur fixe sysadmin.

Valeurs du code de retour

Aucun

Ensembles de résultats

NSNotificationBatchDetails génère trois ensembles de résultats. Le premier contient des informations générales sur le lot de notifications.

Nom de la colonne	Type de données	Description
RuleFiringId	int	Identificateur de l'activation de règle qui a créé le lot de notifications.
StartGenerationTime	datetime	Date et heure de début, au format UTC (Coordinated Universal Time) ou GMT (Greenwich Mean Time), de la création du lot de notifications.
EndGenerationTime	datetime	Date et heure de fin, au format UTC, de la création du lot de notifications.
GenerationTimeInMS	int	Durée, en millisecondes, nécessaire à la création du lot de notifications.
NotificationBatchExpirationTime	datetime	Date et heure d'expiration du lot de notifications, au format UTC. À l'échéance, toutes les éventuelles notifications qui n'ont pas encore été remises sont abandonnées. Aucune autre tentative de remise de ces notifications ne sera effectuée, quelle que soit la planification des nouvelles tentatives. Si cette valeur est NULL, le lot n'a pas de délai d'expiration.
NotificationCount	int	Nombre de notifications du lot de notifications.
StatusDescription	nvarchar(255)	État actuel du lot de notifications.

Le deuxième ensemble de résultats fournit des informations sur la distribution des notifications du lot sur les canaux de remise de l'instance.

Nom de la colonne	Type de données	Description
DeliveryChannelName	nvarchar(255)	Nom du canal de remise.
LastDistributionStartTime	datetime	Dernière date/heure à laquelle le serveur de distribution a commencé à remettre des notifications de ce lot via ce canal de remise.
NotificationsWithNoDeliveryAttempt	int	Nombre de notifications dans ce lot que le serveur de distribution doit encore remettre via ce canal de remise.
NotificationsSuccessfullyDelivered	int	Nombre de remises de notifications réussies à partir de ce lot, via ce canal de remise.
NotificationsFailedToDeliver	int	Nombre d'échecs de remise de notifications de ce lot, pour ce canal de remise.
RetryCount	int	Nombre de fois que le serveur de distribution a sélectionné ce lot de notifications pour remise via ce canal de remise.
NextRetryTime	datetime	Prochaine date/heure à laquelle le serveur de distribution tentera de remettre des notifications de ce lot de notifications via ce canal de remise.

Le troisième ensemble de résultats fournit des informations détaillées sur les notifications du lot.

Nom de la colonne	Type de données	Description
NotificationId	bigint	ID de la notification dans le lot de notifications.
SubscriberId	nvarchar(255)	ID de l'abonné de la notification.
DeviceName	nvarchar(255)	Nom du périphérique d'abonné de la notification.
SubscriberLocale	nvarchar(10)	Nom des paramètres régionaux de la notification.
DeliveryStatus	nvarchar(255)	Description de l'état actuel de remise de la notification.
SentTime	datetime	Date et heure, au format UTC, de la dernière tentative réussie de remise de la notification. Si cette valeur est NULL, la remise de la notification n'a pas été tentée ou n'est pas encore terminée.
LinkedParentNotification	bigint	Si la notification a été envoyée dans un message digest ou de multidiffusion, il s'agit de l'identificateur de la notification de début dans le groupe digest ou de multidiffusion.
DeliveryChannel	nvarchar(255)	Nom du canal de remise qui a envoyé la notification.
DeliveryAttempts	int	Nombre de tentatives de remise effectuées pour la notification.
Notification_class_field_name	défini par l'application	Nom d'un champ de la classe de notifications, tel qu'il est défini dans le fichier de définition de l'application. Chaque champ de la classe de notifications est représenté par une colonne dans l'ensemble de résultats.

Exemples

Cet exemple génère les trois ensembles de résultats spécifiés plus haut dans cette section pour le lot de notifications 1 de la classe de notifications StockNotifications :

L'application utilise les paramètres de SchemaName par défaut, qui placent tous les objets de l'application dans le schéma dbo.

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

Voir aussi

Historique des modifications

Version	Historique
14 avril 2006	Contenu modifié : Correction des descriptions des colonnes du deuxième ensemble de résultats.