NSEventBatchDetails (Transact-SQL)
Retourne des informations détaillées concernant un lot d'événements dans une application Microsoft SQL Server Notification Services. Un ensemble de résultats contient des informations générales sur le lot d'événements, dont le nom du fournisseur et l'heure à laquelle le lot a été collecté. Un deuxième ensemble de résultats affiche les événements qui ont été soumis au lot.
Syntaxe
[ application_schema_name . ] NSEventBatchDetails
[ @EventClassName = ] 'event_class_name' ,
[ @EventBatchId = ] event_batch_id
Arguments
- [ @EventClassName = ] 'event_class_name'
Nom d'une classe d'événements. event_class_name est de type nvarchar(255) et n'a pas de valeur par défaut.
- [ @EventBatchId = ] event_batch_id
Identificateur unique d'une classe d'événements. event_batch_id est de type bigint et n'a pas de valeur par défaut.
Valeurs des codes de retour
Aucun
Notes
Notification Services crée la procédure stockée NSEventBatchDetails 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 figure dans le schéma de l'application, qui est 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.
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
NSEventBatchDetails produit deux ensembles de résultats. Le premier contient des informations générales sur le lot d'événements.
Nom de la colonne | Type de données | Description |
---|---|---|
ProviderName |
nvarchar(255) |
Nom du fournisseur d'événements qui a envoyé le lot d'événements. Cette valeur est NULL si les événements ont été directement insérés dans la vue <EventClassName>. |
EventCount |
bigint |
Nombre d'événements du lot d'événements. |
StartCollectionTime |
datetime |
Date et heure de début de la collecte du lot d'événements, au format UTC (Coordinated Universal Time) ou GMT (Greenwich Mean Time). |
EndCollectionTime |
datetime |
Date et heure de fin de la collecte du lot d'événements, au format UTC. |
CollectionTimeInMS |
int |
Durée totale, en millisecondes, de la collecte du lot d'événements. |
Le deuxième ensemble de résultats contient des détails sur les événements envoyés dans le lot d'événements, classés selon la colonne EventId.
Nom de la colonne | Type de données | Description |
---|---|---|
EventId |
bigint |
Numéro d'identification utilisé pour identifier un événement. |
Event_class_field_name |
défini par l'application |
Nom d'un champ de la classe d'événements, tel qu'il est défini dans le fichier de définition d'application. Chaque champ de la classe d'événements est représenté par une colonne dans l'ensemble de résultats. |
Exemples
A. Utilisation du schéma d'application par défaut
L'exemple suivant montre comment générer le rapport détaillé du lot d'événements. L'application utilise les paramètres de SchemaName par défaut, qui placent tous les objets de l'application dans le schéma dbo.
Ce rapport contient deux ensembles de résultats. Le premier spécifie le fournisseur d'événements et les informations de collecte des événements pour le lot tandis que le second contient les événements envoyés dans le lot d'événements.
EXEC dbo.NSEventBatchDetails
@EventClassName = N'StockEvents',
@EventBatchId = 1;
B. Utilisation d'un schéma d'application nommé
L'exemple suivant montre comment générer le rapport du lot d'événements lorsque la procédure stockée (comme tous les autres objets de l'application) se trouve dans le schéma Stock, ainsi que le spécifie l'élément SchemaName du fichier de configuration d'application.
EXEC Stock.NSEventBatchDetails
@EventClassName = N'StockEvents',
@EventBatchId = 1;
Voir aussi
Référence
Procédures stockées de Notification Services (Transact-SQL)
Autres ressources
Rapports de performances de Notification Services
SchemaName Element (ADF)