NSEventBatchDetails (Transact-SQL)

Artikel
12/15/2008

Gibt ausführliche Informationen zu einem Ereignisbatch in einer Microsoft SQL Server Notification Services-Anwendung zurück. Ein Resultset enthält allgemeine Informationen zu dem Ereignisbatch, wie den Ereignisanbieternamen und die Uhrzeit, zu der der Ereignisbatch aufgelistet wurde. Ein zweites Resultset zeigt die Ereignisse an, die in dem Ereignisbatch übermittelt wurden.

Syntax

[ application_schema_name . ] NSEventBatchDetails 
    [ @EventClassName = ] 'event_class_name' ,
    [ @EventBatchId = ] event_batch_id

Argumente

[ @EventClassName = ] 'event_class_name'
Der Name einer Ereignisklasse. event_class_name ist ein Wert vom Datentyp nvarchar(255) und weist keinen Standardwert auf.

[ @EventBatchId = ] event_batch_id
Ist der eindeutige Bezeichner eines Ereignisbatches. event_batch_id ist ein Wert vom Datentyp bigint und weist keinen Standardwert auf.

Rückgabecodewerte

Keine

Resultsets

NSEventBatchDetails erzeugt zwei Resultsets. Das erste Resultset enthält allgemeine Informationen zu dem Ereignisbatch.

Spaltenname	Datentyp	Beschreibung
ProviderName	nvarchar(255)	Name des Ereignisanbieters, der den Ereignisbatch übermittelt hat. Dieser Wert ist NULL, wenn die Ereignisse direkt in die <EventClassName>-Sicht eingefügt wurden.
EventCount	bigint	Anzahl der Ereignisse im Ereignisbatch.
StartCollectionTime	datetime	Datum und Uhrzeit des Beginns der Ereignisbatchauflistung in UTC (Coordinated Universal Time oder Greenwich Mean Time).
EndCollectionTime	datetime	Datum und Uhrzeit des Endes der Ereignisbatchauflistung in UTC.
CollectionTimeInMS	int	Gesamtzeit (in Millisekunden) für die Auflistung des Ereignisbatches.

Das zweite Resultset enthält Details zu den im Ereignisbatch übermittelten Ereignissen, sortiert nach der EventId-Spalte.

Spaltenname	Datentyp	Beschreibung
EventId	bigint	ID zur Identifizierung eines Ereignisses.
Event_class_field_name	anwendungsdefiniert	Name eines Ereignisklassenfeldes gemäß Definition in der Anwendungsdefinitionsdatei. Jedes Feld in der Ereignisklasse wird durch eine Spalte im Resultset dargestellt.

Hinweise

Notification Services erstellt die gespeicherte Prozedur NSEventBatchDetails in der Anwendungsdatenbank, wenn Sie die Instanz erstellen. Wenn Sie die Anwendung aktualisieren, kompiliert Notification Services die gespeicherte Prozedur erneut.

Diese gespeicherte Prozedur ist Bestandteil des Anwendungsschemas, das durch das SchemaName-Element der Anwendungsdefinitionsdatei angegeben wird. Wenn kein Schemaname bereitgestellt wird, ist dbo das Standardschema.

Berechtigungen

Die Ausführungsberechtigungen erhalten standardmäßig Mitglieder der NSAnalysis-Datenbankrolle, der festen Datenbankrolle db_owner und der festen Serverrolle sysadmin.

Beispiele

A. Verwenden des Standardanwendungsschemas

Im folgenden Beispiel wird das Erstellen des Ereignisbatch-Detailberichts veranschaulicht. Für die Anwendung werden die SchemaName-Standardeinstellungen verwendet, worunter alle Anwendungsobjekte im dbo-Schema angeordnet werden.

Der Bericht enthält zwei Resultsets. Das erste Resultset stellt den Ereignisanbieter und Ereignisauflistungsinformationen für den Ereignisbatch dar, während das zweite Resultset die im Ereignisbatch übermittelten Ereignisse enthält.

EXEC dbo.NSEventBatchDetails 
    @EventClassName = N'StockEvents',
    @EventBatchId = 1;

B. Verwenden eines benannten Anwendungsschemas

Im folgenden Beispiel wird das Erstellen des Ereignisbatchberichts veranschaulicht, wenn die gespeicherte Prozedur (wie alle anderen Anwendungsobjekte) Teil des Stock-Schemas ist, wie im SchemaName-Element der Anwendungsdefinitionsdatei angegeben.

EXEC Stock.NSEventBatchDetails 
    @EventClassName = N'StockEvents',
    @EventBatchId = 1;

Siehe auch

Freigeben über