NSDiagnosticNotificationClass (Transact-SQL)

Article
12/15/2008

Génère le rapport de la classe de notification pour une application Microsoft SQL Server Notification Services. Ce rapport fournit des informations sur le nombre de notifications et de lots de notifications traités par la classe de notification, et indique si les notifications ont put être remises.

Syntaxe

[ schema_name . ] NSDiagnosticNotificationClass 
    [ @ApplicationName = ] 'app_name' ,
    [ @NotificationClassName = ] 'notification_class_name' 
    [, [ @ReportingInterval = ] interval ] 
    [, [ @StartDateTime = ] 'start_date_time' ] 
    [, [ @EndDateTime = ] 'end_date_time' ]

Arguments

[ @ApplicationName=] 'app_name'

Nom d'une application, tel qu'il est défini dans le fichier de configuration. L'argument app_name est de type nvarchar(255) et n'a pas de valeur par défaut.

[ @NotificationClassName=] 'notification_class_name'

Nom de la classe de notification, tel qu'il est défini dans le fichier de définition de l'application. L'argument notification_class_name est de type nvarchar(255) et n'a pas de valeur par défaut.

[ @ReportingInterval=] interval

Nombre de quanta de générateur dans chaque intervalle de rapport. Le rapport contient une ligne par intervalle. L'argument interval est de type int, avec 1 comme valeur par défaut pour indiquer un quantum de générateur par intervalle.

La durée du quantum est définie dans le fichier de définition de l'application.

[ @StartDateTime=] 'start_date_time'

Date et heure de début du rapport au format UTC (Coordinated Universal Time) ou GMT (Greenwich Mean Time). L'argument start_date_time est de type datetime. La valeur par défaut est (5 * QuantumDuration * @ReportingInterval) avant la valeur de @EndDateTime. Avec la valeur par défaut, l'ensemble de résultats contient cinq lignes au plus, chacune d'elles représentant un intervalle de rapport.

[ @EndDateTime=] 'end_date_time'

Date et heure de fin de rapport, en heure UTC. L'argument end_date_time est de type datetime. La valeur par défaut est le résultat de la fonction GETUTCDATE, qui retourne l'heure de l'appel de la procédure stockée.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

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

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

Les lots de notifications sont compris dans un intervalle de rapport lorsque la valeur de EndGenerationTime est supérieure à IntervalStartDateTime et inférieure ou égale à IntervalEndDateTime.

Pour déterminer la date et l'heure UTC actuelles, exécutez SELECT GETUTCDATE() dans SQL Server Management Studio. L'heure UTC actuelle est dérivée de l'heure locale actuelle et du fuseau horaire défini dans le système d'exploitation de l'ordinateur sur lequel SQL Server est exécuté.

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.

Ensembles de résultats

Nom de la colonne	Type de données	Description
IntervalStartDateTime	datetime	Date et heure de début de l'intervalle de rapport au format UTC.
IntervalEndDateTime	datetime	Date et heure de fin de l'intervalle de rapport au format UTC.
NotificationBatchesGenerated	int	Pour la classe de notification, nombre de lots de notifications créés pendant l'intervalle de rapport.
NotificationsGenerated	int	Pour la classe de notification, nombre de notifications générées pendant l'intervalle de rapport.
NotificationsGeneratedPerSecond	float	Pour la classe de notification, nombre de notifications générées par seconde pendant l'intervalle de rapport.
AvgNotificationBatchWaitTillDistribution	float	Pour la classe de notification, temps d'attente moyen avant que le serveur de distribution sélectionne un lot de notifications pendant l'intervalle de rapport.
NotificationDeliveryAttempts	int	Pour les lots de notifications de la classe de notification donnée qui ont été créés pendant l'intervalle de rapport, nombre de tentatives de remise de notification.
NotificationSuccessfulDeliveries	int	Pour les lots de notifications de la classe de notification donnée qui ont été créés pendant l'intervalle de rapport, nombre de notifications remises.
NotificationFailedAttempts	int	Pour les lots de notifications de la classe de notification donnée qui ont été créés pendant l'intervalle de rapport, nombre de tentatives de remise de notification qui ont échoué.
NotificationsDeliveryNotAttempted	int	Pour les lots de notifications de la classe de notification donnée qui ont été créés pendant l'intervalle de rapport, nombre de notifications que le serveur de distribution n'a pas encore essayé de remettre.
NotificationsNotYetDelivered	int	Pour les lots de notifications de la classe de notification donnée qui ont été créés pendant l'intervalle de rapport, nombre de notifications non remises, soit parce qu'il n'y a pas eu de tentative de remise, soit parce que ces tentatives ont échoué.
NotificationToMessageRatio	float	Pour les lots de notifications créés pendant l'intervalle de rapport, ratio des notifications créées par rapport aux messages envoyés. Pour une remise de type digest ou par multidiffusion, un message peut inclure plusieurs notifications. Cette colonne indique le nombre de notifications, en moyenne, incluses dans des messages de type digest ou par multidiffusion.
AvgNotificationBatchSucceedDeliveryTime	float	Pour les lots de notifications créés pendant l'intervalle de rapport, temps moyen pour parvenir à envoyer des notifications via le processus de distribution.

Exemples

A. Spécification de l'intervalle de rapport, de l'heure de début et de l'heure de fin

L'exemple suivant génère le rapport de diagnostic de la classe de notification pour l'application Flight et la classe de notification FlightNotifications. L'instance utilise les paramètres de base de données par défaut, qui placent tous les objets de l'instance dans le schéma dbo.

Le rapport inclut 60 quanta de générateur dans chaque intervalle de rapport. Il commence à 17 heures le 23 mai 2002 et se termine à 18 heures le même jour :

EXEC dbo.NSDiagnosticNotificationClass 
    @ApplicationName = N'Flight', 
    @NotificationClassName = N'FlightNotifications', 
    @ReportingInterval = 60, 
    @StartDateTime = '2004-05-23 17:00', 
    @EndDateTime = '2004-05-23 18:00';

B. Utilisation des valeurs par défaut et d'un schéma nommé

L'exemple suivant génère le rapport de diagnostic de la classe de notification pour l'application Flight et la classe de notification FlightNotifications. Dans cet exemple, la procédure stockée (comme tous les objets de l'instance) se trouve dans le schéma FlightInstance, tel que le spécifie l'élément SchemaName du fichier de configuration de l'instance.

Le rapport utilise des valeurs par défaut, spécifiant l'affichage des données des cinq derniers quanta de générateur.

EXEC FlightInstance.NSDiagnosticNotificationClass 
    @ApplicationName = N'Flight', 
    @NotificationClassName = N'FlightNotifications';

Voir aussi