NSEventBatchDetails (Transact-SQL)

Article
12/15/2008

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