NSScheduledSubscriptionList (Transact-SQL)

發行項
12/15/2008

產生 Microsoft SQL Server Notification Services 應用程式之已排程的訂閱清單報表。這份報表包含給定訂閱者所有已排程之訂閱的相關資訊。

結果會處理本機時間轉換，且會關聯於地區設定，將日光節約時間偏移變更列入考量。當診斷訂閱未在預期時間產生通知的原因時，這些結果非常重要。使用者往往會設定不正確的訂閱資訊，結果會在非預期的時間產生通知。

語法

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

引數

[ @SubscriberId = ] 'subscriber_id'

這是用來代表 Notification Services 執行個體中之訂閱者的唯一識別碼。subscriber_id 是 nvarchar(255)，沒有預設值。

[ @StartDate = ] 'start_date'

這是已排程之訂閱的開始日期和時間，以國際標準時間 (UTC) 或格林威治標準時間 (GMT) 表示。start_date 是 datetime，沒有預設值。

[ @EndDate = ] 'end_date'

這是已排程之訂閱的結束日期和時間 (以 UTC 為單位)。如果未指定 (或 NULL)，預設值是 start_date 值加一天。end_date 是 datetime。

[ @Language = ] 'language_code'

這是一種 Notification Services 語言，用來指定報表中所包括的語言。language_code 用來從執行個體資料庫的 NSTimeZoneNames 資料表中，傳回部份時區。language_code 是 nvarchar(6)，預設值是 'en' (英文)。

如需 language_code 值的完整清單，請參閱＜Subscriber Locale Codes＞。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

NSScheduledSubscriptionList 結果集是先依 SubscriptionClassName 值，再依 SubscriptionId 值來排序。

資料行名稱	資料類型	描述
SubscriberEnabled	tinyint	指出目前是否已啟用訂閱者。非零值表示已啟用訂閱者，可以產生通知。
SubscriptionClassName	nvarchar(255)	包含訂閱者已排程之訂閱的訂閱類別名稱。
SubscriptionId	bigint	訂閱者的訂閱識別碼。
SubscriptionEnabled	tinyint	指出是否已啟用訂閱。非零值表示已啟用訂閱，可以產生通知。
ScheduleText	nvarchar(2048)	使用者提供的訂閱排程文字。
UtcDateTime	datetime	將處理已排程之訂閱的日期和時間 (以 UTC 為單位)。如果值是 NULL，便表示未在指定時間範圍內排程訂閱。
LocalTimeZone	nvarchar(100)	訂閱的本機時區名稱。
Observing	nvarchar(100)	指出訂閱是否遵照日光節約時間。傳回的文字字串是特定時區專用字串。
LocalDateTime	datetime	已排程之訂閱的本機日期和時間。這個日期和時間指出時區採用日光節約時間或標準時間。如果值是 NULL，便表示未在指定時間範圍內排程訂閱。

備註

當您建立執行個體時，Notification Services 會在應用程式資料庫中，建立 NSScheduledSubscriptionList 預存程序。當您更新應用程式時，Notification Services 會重新編譯預存程序。

這個預存程序在應用程式定義檔案 (ADF) 的 SchemaName 元素所指定的應用程式結構描述中。如果未提供結構描述名稱，預設結構描述便是 dbo。

若要判斷目前的 UTC 日期和時間，請在 SQL Server Management Studio 中，執行 SELECT GETUTCDATE()。目前 UTC 時間是從目前本機時間和執行 SQL Server 之電腦的作業系統時區設定衍生而來。

權限

執行權限預設會授與 NSAnalysis 和 db_owner 資料庫角色以及系統管理員 (sysadmin) 固定伺服器角色的成員。

範例

A. 取得特定日期已排程的訂閱

下列範例會顯示如何產生訂閱者 "karen" 在 2004 年 5 月 24 日所有已排程之訂閱的報表。

應用程式使用預設的 SchemaName 設定，這項設定會將所有應用程式物件放在 dbo 結構描述中。

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

B. 取得特定期間已排程的訂閱

下列範例會顯示如何產生訂閱者 "karen" 前兩天所有已排程之訂閱的報表。

在這個範例中，依照 ADF 的 SchemaName 元素所指定，預存程序 (如同所有其他應用程式物件) 是在 Stock 結構描述中。

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

請參閱

共用方式為

NSScheduledSubscriptionList (Transact-SQL)

語法

引數

傳回碼值

結果集

備註

權限

範例

A. 取得特定日期已排程的訂閱

B. 取得特定期間已排程的訂閱

請參閱

參考

其他資源

說明及資訊

其他資源