NSScheduledSubscriptionList (Transact-SQL)

Artikel
12/15/2008

Erstellt den geplanten Abonnementlistenbericht für eine Microsoft SQL Server Notification Services-Anwendung. Der Bericht enthält Informationen zu allen geplanten Abonnements eines bestimmten Abonnenten.

Die Ergebnisse berücksichtigen die Ortszeit sowie durch Sommerzeit bedingte Änderungen im Hinblick auf das Gebietsschema. Die Ergebnisse können für die Diagnose der Ursache verwendet werden. Deshalb wurde keine Benachrichtigung zu einer erwarteten Uhrzeit für ein Abonnement generiert. Es kommt häufig vor, dass Benutzer Abonnementinformationen falsch konfigurieren. Dies hat zur Folge, dass Benachrichtigungen zu unerwarteten Zeiten generiert werden.

Syntax

[ schema_name . ] NSScheduledSubscriptionList 
    [ @SubscriberId = ] 'subscriber_id',
    [ @StartDate = ] 'start_date' ]
    [, [ @EndDate = ] 'end_date' ]
    [, [ @Language = ] 'language_code' ]

Argumente

[ @SubscriberId = ] 'subscriber_id'

Ist der eindeutige Bezeichner, der einen Abonnenten in der Notification Services-Instanz darstellt. subscriber_id ist ein Wert vom Datentyp nvarchar(255) und weist keinen Standardwert auf.

[ @StartDate = ] 'start_date'

Ist das Startdatum und die Startzeit in UTC (Coordinated Universal Time oder Greenwich Mean Time) für geplante Abonnements. start_date ist ein Wert vom Datentyp datetime und weist keinen Standardwert auf.

[ @EndDate = ] 'end_date'

Ist das Enddatum und die Beendigungszeit in UTC für geplante Abonnements. Bei fehlender Angabe (oder NULL) entspricht der Standardwert dem start_date-Wert plus einen Tag. end_date ist ein Wert vom Datentyp datetime.

[ @Language = ] 'language_code'

Ist eine der Notification Services-Sprachen und gibt die Sprache an, die in den Bericht eingeschlossen werden soll. language_code wird zur Rückgabe bestimmter Zeitzonen aus der NSTimeZoneNames-Tabelle in der Instanzdatenbank verwendet. language_code ist ein Wert vom Datentyp nvarchar(6); der Standardwert ist 'en' (Englisch).

Eine vollständige Liste der language_code-Werte finden Sie unter Subscriber Locale Codes.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Das NSScheduledSubscriptionList-Resultset wird zuerst nach dem SubscriptionClassName-Wert und dann nach dem SubscriptionId-Wert sortiert.

Spaltenname	Datentyp	Beschreibung
SubscriberEnabled	tinyint	Gibt an, ob der Abonnent derzeit aktiviert ist. Ein Wert ungleich Null gibt an, dass der Abonnent aktiviert ist und Benachrichtigungen generieren kann.
SubscriptionClassName	nvarchar(255)	Name der Abonnementklasse mit dem geplanten Abonnement für den Abonnenten.
SubscriptionId	bigint	ID eines Abonnements für den Abonnenten.
SubscriptionEnabled	tinyint	Gibt an, ob das Abonnement aktiviert ist. Ein Wert ungleich Null gibt an, dass das Abonnement aktiviert ist und Benachrichtigungen generieren kann.
ScheduleText	nvarchar(2048)	Vom Benutzer bereitgestellter Zeitplantext für das Abonnement.
UtcDateTime	datetime	Datum und Uhrzeit in UTC für die Verarbeitung des geplanten Abonnements. Ist der Wert gleich NULL, fällt die Uhrzeit des geplanten Abonnements nicht in den angegebenen Zeitraum.
LocalTimeZone	nvarchar(100)	Name der lokalen Zeitzone für das Abonnement.
Observing	nvarchar(100)	Gibt an, ob das Abonnement die Sommerzeit berücksichtigt. Die zurückgegebene Textzeichenfolge ist die für die Zeitzone spezifische Zeichenfolge.
LocalDateTime	datetime	Ortszeit und Datum für das geplante Abonnement. Datum und Uhrzeit geben an, ob die Zeitzone der Sommer- oder Standardzeit unterliegt. Ist der Wert gleich NULL, fällt die Uhrzeit des geplanten Abonnements nicht in den angegebenen Zeitraum.

Hinweise

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

Wenn Sie das aktuelle UTC-Datum bzw. die UTC-Uhrzeit ermitteln möchten, führen Sie SELECT GETUTCDATE() in SQL Server Management Studio aus. Die aktuelle UTC-Zeit wird von der aktuellen lokalen Zeit und der Zeitzoneneinstellung im Betriebssystem des Computers mit SQL Server abgeleitet.

Berechtigungen

Die Ausführungsberechtigungen erhalten standardmäßig Mitglieder der Datenbankrollen NSAnalysis und db_owner sowie Mitglieder der festen Serverrolle sysadmin.

Beispiele

A. Abrufen von für ein bestimmtes Datum geplanten Abonnements

Im folgenden Beispiel wird gezeigt, wie ein Bericht aller Abonnements erstellt wird, die für den 24. Mai 2004 für den Abonnenten 'karen' geplant waren.

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

EXEC dbo.NSScheduledSubscriptionList 
    @SubscriberId = N'karen', 
    @StartDate = '2004-05-24', 
    @EndDate = '2004-05-24 23:59:59';

B. Abrufen von für einen bestimmten Zeitraum geplanten Abonnements

Im folgenden Beispiel wird gezeigt, wie ein Bericht aller Abonnements erstellt wird, die für die letzten zwei Tage für den Abonnenten 'karen' geplant waren.

In diesem Beispiel befindet sich die gespeicherte Prozedur (wie alle anderen Anwendungsobjekte) im Stock-Schema gemäß Definition im SchemaName-Element der ADF.

DECLARE @start datetime;
SET @start = DATEADD(day, -2, GETUTCDATE());
EXEC Stock.NSScheduledSubscriptionList 
    @SubscriberId = N'karen', 
    @StartDate = @start;

Siehe auch

Share via