NSNotificationBatchDetails (Transact-SQL)

Artikel
12/15/2008

Aktualisiert: 14. April 2006

Erstellt den Benachrichtigungsbatch-Detailbericht für eine Microsoft SQL Server Notification Services-Anwendung. Der Bericht enthält Informationen zu einem bestimmten Benachrichtigungsbatch, wie z. B. der Regelauslösung, die den Batch erstellt hat, und den im Batch enthaltenen Benachrichtigungen. Verwenden Sie diese gespeicherte Prozedur für die Problembehandlung bei der Benachrichtigungsgenerierung und für die Analyse des Weges von Benachrichtigungen durch die Anwendung.

Syntax

[ application_schema_name . ] NSNotificationBatchDetails 
    [ @NotificationClassName = ] 'notification_class_name',
    [ @NotificationBatchId = ] notification_batch_id

Argumente

[ @NotificationClassName = ] 'notification_class_name'
Der Name einer Benachrichtigungsklasse. notification_class_name ist ein Wert vom Datentyp nvarchar(255) und weist keinen Standardwert auf.

[ @NotificationBatchId = ] notification_batch_id
Der eindeutige Bezeichner für die Identifizierung eines Benachrichtigungsbatches. notification_batch_id ist ein Wert vom Datentyp bigint und weist keinen Standardwert auf.

Rückgabecodewerte

Keine

Resultsets

NSNotificationBatchDetails erstellt drei Resultsets. Das erste Resultset stellt allgemeine Informationen zum Benachrichtigungsbatch bereit.

Spaltenname	Datentyp	Beschreibung
RuleFiringId	int	Eindeutige ID der Regelauslösung, die den Benachrichtigungsbatch erstellt hat.
StartGenerationTime	datetime	Startdatum und -zeit in UTC (Coordinated Universal Time oder Greenwich Mean Time) der Benachrichtigungsbatchgenerierung.
EndGenerationTime	datetime	Enddatum und Beendigungszeit in UTC der Benachrichtigungsbatchgenerierung.
GenerationTimeInMS	int	Zeit in Millisekunden für die Generierung des Benachrichtigungsbatchs.
NotificationBatchExpirationTime	datetime	Datum und Uhrzeit des Ablaufs des Benachrichtigungsbatchs in UTC. Nach dem Ablaufzeitpunkt werden alle verbliebenen nicht übermittelten Benachrichtigungen verworfen. Unabhängig vom Wiederholungszeitplan wird kein weiterer Versuch zur Übermittlung dieser Benachrichtigungen unternommen. Wenn dieser Wert NULL ist, liegt kein Ablaufzeitpunkt für den Batch vor.
NotificationCount	int	Anzahl von Benachrichtigungen im Benachrichtigungsbatch.
StatusDescription	nvarchar(255)	Aktueller Status des Benachrichtigungsbatchs.

Das zweite Resultset stellt Informationen zur Verteilung der Benachrichtigungen im Batch innerhalb der Übermittlungskanäle in der Instanz bereit.

Spaltenname	Datentyp	Beschreibung
DeliveryChannelName	nvarchar(255)	Der Name des Übermittlungskanals.
LastDistributionStartTime	datetime	Zeitpunkt, zu dem der Verteiler zuletzt mit der Übermittlung von Benachrichtigungen aus diesem Benachrichtigungsbatch über diesen Übermittlungskanal begonnen hat.
NotificationsWithNoDeliveryAttempt	int	Anzahl von Benachrichtigungen, die der Verteiler noch aus diesem Benachrichtigungsbatch über diesen Übermittlungskanal zu übermitteln hat.
NotificationsSuccessfullyDelivered	int	Anzahl von erfolgreichen Benachrichtigungsübermittlungen aus diesem Benachrichtigungsbatch über diesen Übermittlungskanal.
NotificationsFailedToDeliver	int	Anzahl von fehlgeschlagenen Benachrichtigungsübermittlungen aus diesem Benachrichtigungsbatch für diesen Übermittlungskanal.
RetryCount	int	Häufigkeit, mit der der Verteiler den Benachrichtigungsbatch für die Übermittlung über diesen Übermittlungskanal abgerufen hat.
NextRetryTime	datetime	Nächster Zeitpunkt, zu dem der Verteiler versucht, Benachrichtigungen aus diesem Benachrichtigungsbatch über diesen Übermittlungskanal zu übermitteln.

Das dritte Resultset stellt ausführliche Informationen zu Benachrichtigungen im Benachrichtigungsbatch bereit.

Spaltenname	Datentyp	Beschreibung
NotificationId	bigint	ID der Benachrichtigung im Benachrichtigungsbatch.
SubscriberId	nvarchar(255)	ID des Abonnenten für die Benachrichtigung.
DeviceName	nvarchar(255)	Name des Abonnentengeräts für die Benachrichtigung.
SubscriberLocale	nvarchar(10)	Name des Gebietsschemas für die Benachrichtigung.
DeliveryStatus	nvarchar(255)	Beschreibung des aktuellen Übermittlungsstatus für die Benachrichtigung.
SentTime	datetime	Datum und Uhrzeit in UTC, zu der der letzte Übermittlungsversuch für die Benachrichtigung abgeschlossen wurde. Ist dieser Wert NULL, wurde noch kein Übermittlungsversuch für die Benachrichtigung unternommen, oder der Versuch wurde noch nicht abgeschlossen.
LinkedParentNotification	bigint	Kopfteilbenachrichtigungs-ID in der Digest- oder Multicastgruppe, wenn die Benachrichtigung in einer Digest- oder Multicastnachricht gesendet wurde.
DeliveryChannel	nvarchar(255)	Name des Übermittlungskanals, der die Benachrichtigung gesendet hat.
DeliveryAttempts	int	Anzahl von Übermittlungsversuchen für die Benachrichtigung.
Notification_class_field_name	anwendungsdefiniert	Der Name eines Benachrichtigungsklassenfeldes gemäß Definition in der Anwendungsdefinitionsdatei (ADF, Application Definition File). Jedes Feld in der Benachrichtigungsklasse wird durch eine Spalte im Resultset dargestellt.

Hinweise

Notification Services erstellt die gespeicherte Prozedur NSNotificationBatchDetails 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

In diesem Beispiel werden die drei weiter oben in diesem Abschnitt beschriebenen Resultsets für den Benachrichtigungsbatch 1 der StockNotifications-Benachrichtigungsklasse erstellt:

Für die Anwendung werden die SchemaName-Standardeinstellungen verwendet, worunter alle Anwendungsobjekte im dbo-Schema angeordnet werden.

EXEC dbo.NSNotificationBatchDetails 
    @NotificationClassName = N'StockNotifications', 
    @NotificationBatchId = 1;

Siehe auch

Änderungsverlauf

Version	Verlauf
14. April 2006	Geänderter Inhalt: Die Spaltenbeschreibungen im zweiten Resultset wurden korrigiert.

Share via