NSAdministrationHistory (Transact-SQL)

Article
12/15/2008

Produit le rapport d'historique d'administration pour une instance de Microsoft SQL Server Notification Services. Ce rapport contient des informations sur toutes les applications hébergées par l'instance, y compris les événements, les abonnements et les notifications traités selon un intervalle de temps spécifique.

Syntaxe

[ schema_name . ] NSAdministrationHistory 
    [  [ @ApplicationName = ] 'app_name' ],
    [, [ @ReportingIntervalInMinutes = ] interval ] 
    [, [ @StartDateTime = ] 'start_date_time' ] 
    [, [ @EndDateTime = ] 'end_date_time' ]

Arguments

[ @ApplicationName=] 'app_name'

Nom de l'application Notification Services, comme défini dans le fichier de configuration d'instance. app_name est de type nvarchar(255) et possède une valeur par défaut NULL qui indique de créer un rapport sur toutes les applications hébergées par cette instance.

[ @ReportingIntervalInMinutes = ] interval

Nombre de minutes pour chaque intervalle de création de rapport. Ce rapport contient une ligne par intervalle. interval est de type int et possède une valeur par défaut 60, qui indique 60 minutes par intervalle de création de rapport.

[ @StartDateTime=] 'start_date_time'

Date et heure de début du rapport, selon l'heure de Greenwich (UTC). start_date_time est de type datetime et possède une valeur par défaut d'un mois avant la valeur @EndDateTime.

[ @EndDateTime=] 'end_date_time'

Date et heure de fin de rapport, en heure UTC. La valeur end_date_time possède un type de données datetime. La valeur par défaut est le résultat de la fonction GETUTCDATE, qui renvoie l'heure à laquelle fut invoquée la procédure stockée.

Valeurs des codes de retour

Aucun

Jeux de résultats

Nom de la colonne	Type de données	Description
ApplicationName	nvarchar(255)	Nom de l'application résumée par la ligne. Cette valeur est NULL pour la ligne résumant l'instance.
IntervalStartDateTime	datetime	Date et heure UTC du début de l'intervalle de création de rapport.
IntervalEndDateTime	datetime	Date et heure UTC de fin de l'intervalle de création de rapport.
EventBatchCollectedCount	int	Nombre de lots d'événements collectés au cours de l'intervalle de création de rapport, en fonction de la valeur EndCollectionTime du lot d'événements.
EventsCollectedCount	int	Nombre d'événements collectés au cours de l'intervalle de création de rapport, en fonction de la valeur EndCollectionTime du lot d'événements.
EventsCollectedPerSecond	float	Lors d'une collecte d'événements, correspond au nombre moyen d'événements collectés par seconde au cours de l'intervalle de création de rapport.
EventBatchesAwaitingGeneration	int	Nombre de lots d'événements écrits dans la base de données mais pas traités par le générateur.
EventBatchesInCollection	int	Nombre de lots d'événements à l'étape de collecte d'événements au cours de l'intervalle de création de rapport.
NotificationBatchGeneratedCount	int	Nombre de lots de notifications écrits au cours de l'intervalle de création de rapport, en fonction de la valeur EndGenerationTime du lot de notifications.
NotificationsGeneratedCount	int	Nombre de notifications générées au cours de l'intervalle de création de rapport, en fonction de la valeur EndGenerationTime du lot de notifications.
NotificationsGeneratedPerSecond	float	Nombre moyen de notifications générées par seconde au cours de l'intervalle de création de rapport.
NotificationBatchesInGeneration	int	Nombre de lots de notifications dans le processus en cours de création par le générateur lors de l'intervalle de création de rapport.
NotificationBatchesAwaitingDistribution	int	Nombre de lots de notifications en attente de sélection par le distributeur au cours de l'intervalle de création de rapport.
NotificationsSuccessfulDeliveredCount	int	Nombre de notifications livrées avec succès au cours de l'intervalle de création de rapport.
NotificationsFailedDeliveryCount	int	Nombre de notifications dont la livraison a échoué et qui ont été indiquées comme expirées au cours de l'intervalle de création de rapport.
WorkItemsInProgress	int	Nombre d'éléments de travail en cours de distribution pendant l'intervalle de création de rapport.
SubscriptionsAddedCount	int	Nombre d'abonnements ajoutés à l'application au cours de l'intervalle de création de rapport.
ScheduledSubscriptionsAdded	int	Nombre d'abonnements planifiés ajoutés à l'application au cours de l'intervalle de création de rapport.
SubscriptionsModified	int	Nombre d'abonnements modifiés dans l'application au cours de l'intervalle de création de rapport.
SubscribersAddedCount	int	Nombre d'abonnés ajoutés à l'instance au cours de l'intervalle de création de rapport.
SubscriberDevicesAddedCount	int	Nombre de périphériques d'abonné ajoutés au cours de l'intervalle de création de rapport. Le périphérique est censé être ajouté en même temps que l'abonné.
SubscriberDevicesModifiedCount	int	Nombre de périphériques d'abonné mis à jour au cours de l'intervalle de création de rapport. Le périphérique est censé être mis à jour en même temps que l'abonné.

Notes

Notification Services crée la procédure stockée NSAdministrationHistory 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 de l'instance du fichier de configuration d'instance. Si aucun nom de schéma n'est spécifié, le schéma par défaut est dbo.

La quantité de données rassemblées par ce rapport est limitée par la période de rétention du processus de ramasse-miettes spécifiée dans l'élément VacuumDuration du fichier de définition de l'application. Seules les données qui n'ont pas été supprimées peuvent être analysées.

Pour déterminer la date et l'heure UTC en cours, exécutez la requête Transact-SQL SELECT GETUTCDATE(). L'heure UTC courante provient du paramètre d'heure locale en cours et de fuseau horaire du système d'exploitation de l'ordinateur.

Autorisations

Les autorisations d'exécution reviennent 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 de celui de serveur fixe sysadmin.

Exemples

A. Historique d'administration de vol

L'exemple suivant produit le rapport d'historique d'administration pour l'application de vol. L'instance utilise les paramètres de base de données par défaut, qui place tous les objets d'instance dans le schéma dbo.

L'intervalle de rapport est de 120 minutes. Le rapport démarre à 11:30 le 22 septembre 2004 et se termine à 14:30 le même jour.

EXEC dbo.NSAdministrationHistory 
    @ApplicationName = N'Flight', 
    @ReportingIntervalInMinutes = 120, 
    @StartDateTime = '2004-09-22 11:30:00', 
    @EndDateTime = '2004-09-22 14:30:00';

B. Historique de l'administration de toutes les applications

L'exemple suivant produit le rapport d'historique d'administration de toutes les applications hébergées par l'instance. Dans cet exemple, la procédure stockée se trouve dans le schéma FlightInstance, comme spécifié dans l'élément SchemaName du fichier de configuration d'instance.

Le rapport utilise des valeurs par défaut, qui indiquent d'afficher toutes les données du mois précédent à l'aide d'un intervalle de création de rapport de 60 minutes.

EXEC FlightInstance.NSAdministrationHistory;

Voir aussi