NSAdministrationHistory (Transact-SQL)
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
Référence
Procédures stockées de Notification Services (Transact-SQL)
Autres ressources
Rapports de performances de Notification Services
SchemaName Element (ICF)