Share via


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)

Hilfe und Informationen

Informationsquellen für SQL Server 2005