NSQuantumDetails (Transact-SQL)
Retourne des informations détaillées sur un quantum. Utilisez cette procédure stockée pour résoudre les problèmes des quanta longs et analyser le traitement d'un quantum.
Syntaxe
[ schema_name . ] NSQuantumDetails
[ @QuantumId = ] quantum_id
Arguments
- [ @QuantumId = ] quantum_id
Représente l'ID d'un quantum pour le rapport. quantum_id est de type int et n'a pas de valeur par défaut. Utilisez les procédures stockées NSQuantumList, NSQuantumExecutionTime et NSQuantumFailures pour obtenir les ID de quantum.
Jeux de résultats
NSQuantumDetails génère cinq jeux de résultats. Le premier jeu de résultats contient des informations d'ordre général sur le quantum.
| Nom de la colonne | Type de données | Description |
|---|---|---|
QuantumStartTime |
datetime |
Heure UTC de début de l'intervalle représenté par le quantum. |
QuantumEndTime |
datetime |
Heure UTC de fin de l'intervalle représenté par le quantum ; l'heure de fin correspond au cumul de l'heure de début et de la durée du quantum. |
QuantumStatusDescription |
nvarchar(255) |
Description de l'état actuel du quantum. |
ExecutionTimeInMS |
int |
Temps, en millisecondes, nécessaire au traitement du quantum. |
ExecutionStartTime |
datetime |
Date et heure UTC réels auxquels le générateur a démarré le traitement du quantum. |
ExecutionEndTime |
datetime |
Date et heure UTC réels auxquels le générateur a terminé le traitement du quantum. |
EventNotificationsGenerated |
bigint |
Lors de l'exécution du quantum, nombre de notifications générées à partir de règles déclenchées par des événements. |
ScheduledNotificationsGenerated |
bigint |
Lors de l'exécution du quantum, nombre de notifications générées à partir de règles d'abonnement planifiées. |
ChronicleRuleFiringsSkipped |
nvarchar(255) |
Indique si des activations de règle de chronique d'événements ont été ignorées au cours de ce quantum. |
SubscriptionRuleFiringsSkipped |
nvarchar(255) |
Indique si des activations de règle d'abonnement ont été ignorées au cours de ce quantum. |
Le second jeu de résultats contient des informations sur les activations de règle de quantum.
| Nom de la colonne | Type de données | Description |
|---|---|---|
RuleFiringId |
int |
Identificateur unique de règle activée pendant le quantum. |
RuleName |
nvarchar(255) |
Nom de la règle tel qu'il est défini dans le fichier de définition d'application. |
ExecutionTimeInMS |
int |
Temps, en millisecondes, nécessaire à l'activation de la règle. |
PercentageQuantumTime |
numeric(7, 4) |
Pourcentage du temps d'exécution global du quantum utilisé pour activer la règle. |
ExecutionStartTime |
datetime |
Date et heure UTC de début pour l'activation de la règle. |
ExecutionEndTime |
datetime |
Date et heure UTC de fin pour l'activation de la règle. |
RuleTypeDescription |
nvarchar(250) |
Décrit le type de règle exécutée : règle de chronique d'événements, d'abonnement d'événement ou d'abonnement planifiée. |
EventClassName |
nvarchar(255) |
Nom de la classe d'événements des événements traités lors de l'activation de la règle. Si le type d'activation est une règle d'abonnement planifiée, cette colonne est NULL car ces règles ne sont pas déclenchées par des événements. |
EventCount |
bigint |
Nombre d'événements traités par la règle. |
EventBatchId |
bigint |
Identificateur du lot d'événements qui contient les événements traités lors de l'activation de la règle. Si le type d'activation est une règle d'abonnement planifiée ou si la valeur ProcessEventsInOrder dans le fichier de définition d'application est false, cette colonne est NULL car la règle a peut-être traité plusieurs lots d'événements. |
SubscriptionClassName |
nvarchar(255) |
Nom de la classe d'abonnement des abonnements traités lors de l'activation de la règle. Si le type d'activation est une règle de chronique d'événements, cette colonne est NULL. |
SubscriptionCount |
bigint |
Estimation du nombre d'abonnements traités par la règle. Cette estimation est basée sur l'état actuel des abonnements dans la base de données d'application. Au moment de l'activation de la règle, la base de données pouvait contenir un nombre supérieur ou inférieur d'abonnements. |
StartScanTime |
datetime |
Date et heure UTC de début des abonnements planifiés utilisés par la règle. Cette colonne contient une valeur uniquement lorsque le type de règle est une règle d'abonnement planifiée et que l'application traite les événements dans l'ordre. |
EndScanTime |
datetime |
Date et heure UTC de fin des abonnements planifiés utilisés par la règle. Cette colonne contient une valeur uniquement lorsque le type de règle est une règle d'abonnement planifiée et que l'application traite les événements dans l'ordre. |
NotificationsGenerated |
int |
Nombre de notifications générées par l'activation de la règle. |
Le troisième jeu de résultats contient des informations concernant les lots d'événements recueillis pendant le quantum.
| Nom de la colonne | Type de données | Description |
|---|---|---|
EventClassName |
nvarchar(255) |
Nom d'une classe d'événements qui a soumis un lot d'événements. |
EventBatchId |
bigint |
Identificateur du lot d'événements. |
EventCount |
bigint |
Nombre d'événements dans le lot d'événements. |
StartCollectionTime |
datetime |
Date et heure UTC de début pour la collection de lots d'événements. |
EndCollectionTime |
datetime |
Date et heure UTC de fin pour la collection de lots d'événements. |
CollectionTimeInMS |
int |
Temps total, en millisecondes, pour collecter le lot d'événements. |
ProviderName |
nvarchar(255) |
Nom du fournisseur d'événements qui a soumis le lot d'événements. Cette valeur est NULL si les événements ont été directement insérés dans la vue <EventClassName>. |
SystemName |
nvarchar(255) |
Nom du système sur lequel le fournisseur d'événement est exécuté. Cette valeur est NULL pour les fournisseurs d'événements non hébergés ou si les événements ont été directement insérés dans la vue <EventClassName>. |
Le quatrième jeu de résultats contient des informations concernant les abonnements traités pendant le quantum.
| Nom de la colonne | Type de données | Description |
|---|---|---|
SubscriptionClassName |
nvarchar(255) |
Nom d'une classe d'abonnement pour laquelle les abonnements ont été traités pendant le quantum. |
EventSubscriptionCount |
bigint |
Estimation du nombre d'abonnements actifs déclenchés par des événements pour la classe d'abonnement pendant la période de quantum. |
ScheduledSubscriptionCount |
bigint |
Estimation du nombre d'abonnements planifiés actifs pour la classe d'abonnement pendant la période de quantum. |
Le cinquième rapport contient des informations concernant les notifications générées pendant le quantum.
Nom de la colonne
Type de données
Description
NotificationClassName
nvarchar(255)
Nom de la classe d'événement à laquelle les notifications appartiennent.
NotificationBatchId
bigint
Identificateur unique d'un lot de notifications généré par l'activation d'une règle dans le quantum.
RuleFiringId
int
Identificateur unique de l'activation de règle qui a généré le lot de notifications.
NotificationCount
int
Nombre de notifications dans le lot de notifications.
NotificationDeliveryAttempts
int
Nombre de tentatives pour fournir les notifications du lot de notifications.
.gif "ms186227.note(fr-fr,SQL.90).gif")
Remarque :
Si une notification a été transmise au protocole de remise et que son état n'est pas signalé par ce protocole, la notification n'est pas comptée parmi les tentatives.
NotificationSuccessfulDeliveries
int
Nombre de remises de notification réussies du lot de notifications.
NotificationFailedAttempts
int
Nombre d'échecs de remises de notification du lot de notifications.
NotificationsDeliveryNotAttempted
int
Nombre de notifications qui n'ont pas encore fait l'objet d'une tentative de remise par le serveur de distribution.
NotificationsNotYetDelivered
int
Nombre de notifications qui n'ont pas encore été remises par le serveur de distribution.
NotificationToMessageRatio
float
Pourcentage des notifications générées par rapport aux messages envoyés.
Pour une remise de type digest ou par multidiffusion, un message peut contenir plusieurs notifications. Cette colonne indique le nombre moyen de notifications inclus dans les messages de type digest ou par multidiffusion.
AvgNotificationBatchSucceedDeliveryTime
float
Temps moyen, en secondes, pour envoyer les notifications par le biais du processus de distribution.
Notes
Notification Services crée la procédure stockée NSQuantumDetails dans la base de données d'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, spécifié par l'élément SchemaName du fichier de définition d'application. Si aucun nom de schéma n'est spécifié, le schéma par défaut est dbo.
Après avoir obtenu des informations détaillées sur un quantum, vous pouvez effectuer une recherche approfondie à l'aide des procédures stockées suivantes :
- NSEventBatchDetails (Transact-SQL)
- NSNotificationBatchDetails (Transact-SQL)
- NSScheduledSubscriptionDetails (Transact-SQL)
Autorisations
Les autorisations d'exécution reviennent par défaut aux membres des rôles de base de données NSAnalysis et db_owner et aux membres du rôle de serveur fixe sysadmin.
Valeurs des codes renvoyés
Aucun
Exemple
L'exemple ci-après génère les cinq jeux de résultats répertoriés précédemment dans cette section pour le premier quantum du générateur d'une application :
L'application utilise le paramètre par défaut SchemaName, qui insère tous les objets de l'application dans le schéma dbo.
EXEC dbo.NSQuantumDetails
@QuantumId = 1;
Voir aussi
Référence
Procédures stockées de Notification Services (Transact-SQL)
NSEventBatchDetails (Transact-SQL)
NSNotificationBatchDetails (Transact-SQL)
NSScheduledSubscriptionDetails (Transact-SQL)
Autres ressources
Rapports de performances de Notification Services
SchemaName Element (ADF)