NSScheduledSubscriptionDetails (Transact-SQL)
Gibt ausführliche Informationen zu den Abonnements einer Abonnementklasse in einer Microsoft SQL Server Notification Services-Anwendung zurück, die in einem bestimmten Zeitraum ausgewertet werden sollen. Diese gespeicherte Prozedur ist nur in Kombination mit Abonnementklassen funktionsfähig, die über geplante Abonnementregeln verfügen.
Syntax
[ schema_name . ] NSScheduledSubscriptionDetails
[ @SubscriptionClassName = ] 'sub_class_name',
[ @StartTime = ] 'start_time',
[ @EndTime = ] 'end_time'
Argumente
[ @SubscriptionClassName = ] 'sub_class_name'
Der Name einer Abonnementklasse. sub_class_name ist ein Wert vom Datentyp nvarchar(255) und weist keinen Standardwert auf.
[ @StartTime = ] 'start_time'
Startdatum und -uhrzeit in UTC (Coordinated Universal Time, Koordinierte Weltzeit oder Greenwich Mean Time) des relevanten Zeitraums. start_time ist ein Wert vom Datentyp datetime und weist keinen Standardwert auf.
[ @EndTime = ] 'end_time'
Beendigungsdatum und -uhrzeit in UTC des relevanten Zeitraums. end_time ist ein Wert vom Datentyp datetime und weist keinen Standardwert auf. Es ist nicht möglich, einen Wert für end_time anzugeben, der mehr als 24 Stunden hinter dem Wert für start_time liegt.
Rückgabecodewerte
Keine
Resultsets
Das NSScheduledSubscriptionDetails-Resultset wird nach den Werten in ScheduleTime geordnet.
Spaltenname | Datentyp | Beschreibung |
---|---|---|
SubscriptionId |
bigint |
Eindeutige ID des geplanten Abonnements. |
SubscriberId |
nvarchar(255) |
Eindeutige ID des Abonnenten, der Besitzer des Abonnements ist. |
CreationDate |
datetime |
Datum und Uhrzeit (in UTC) der Erstellung des Abonnements. |
UpdateDate |
datetime |
Datum und Uhrzeit (in UTC) des letzten Updates des Abonnements. |
Enabled |
bit |
Gibt an, ob das Abonnement zurzeit aktiviert oder deaktiviert ist. Der Wert 1 gibt an, dass das Abonnement aktiviert ist. |
ScheduleTime |
datetime |
Datum und Uhrzeit (in UTC) der geplanten Verarbeitung des Abonnements. |
Subscription_Class_Field_Name |
anwendungsabhängig |
Der Name des Abonnementklassenfeldes gemäß Definition in der Anwendungsdefinitionsdatei (ADF, Application Definition File). Jedes Feld in der Abonnementklasse wird durch eine Spalte im Resultset dargestellt. |
Hinweise
Notification Services erstellt die gespeicherte Prozedur NSScheduledSubscriptionDetails in der Anwendungsdatenbank, wenn Sie die Instanz erstellen. Wenn Sie die Anwendung aktualisieren, wird die gespeicherte Prozedur von Notification Services neu kompiliert.
Diese gespeicherte Prozedur befindet sich im Schema der Anwendung, das durch das SchemaName-Element der ADF angegeben ist. Wenn kein Schemaname angegeben wird, ist dbo das Standardschema.
Zur Bestimmung des aktuellen Zeitpunktes (Datum und Uhrzeit) in UTC führen Sie SELECT GETUTCDATE() in SQL Server Management Studio aus. Die aktuelle UTC-Zeit wird von der aktuellen Ortszeit und der Zeitzoneneinstellung im Betriebssystem des Computers mit SQL Server abgeleitet.
Berechtigungen
Standardmäßig verfügen Mitglieder der Datenbankrollen NSAnalysis und db_owner und Mitglieder der festen Serverrolle sysadmin über die Berechtigungen zum Ausführen dieser Prozedur.
Beispiele
Im folgenden Beispiel die Erstellung des Berichts zu geplanten Abonnements für die PortfolioSubscriptions-Abonnementklasse der Anwendung Stock dargestellt. Der Bericht enthält Informationen zu Abonnements, die am 23. Mai 2004 ausgeführt werden sollen. Die Zeitwerte basieren auf der UTC-Zeit.
Die Anwendung verwendet die standardmäßigen SchemaName-Einstellungen, wodurch alle Anwendungsobjekte dem dbo-Schema zugeordnet werden.
EXEC dbo.NSScheduledSubscriptionDetails
@SubscriptionClassName = N'PortfolioSubscriptions',
@StartTime = '2004-05-23 00:00:00',
@EndTime = '2004-05-23 23:59:59';
Siehe auch
Verweis
Gespeicherte Prozeduren in Notification Services (Transact-SQL)
Andere Ressourcen
Notification Services-Leistungsberichte
SchemaName Element (ADF)