NSScheduledSubscriptionDetails (Transact-SQL)
傳回排程要在給定期間內評估的 Microsoft SQL Server Notification Services 應用程式中的訂閱類別之各項訂閱的詳細資訊。這個預存程序只會使用已排程的訂閱規則之訂閱類別。
語法
[ schema_name . ] NSScheduledSubscriptionDetails
[ @SubscriptionClassName = ] 'sub_class_name',
[ @StartTime = ] 'start_time',
[ @EndTime = ] 'end_time'
引數
[ @SubscriptionClassName = ] 'sub_class_name'
這是訂閱類別的名稱。sub_class_name 是 nvarchar(255),沒有預設值。
[ @StartTime = ] 'start_time'
這是所需期間的開始日期和時間,以國際標準時間 (UTC) 或格林威治標準時間 (GMT) 表示。start_time 是 datetime,沒有預設值。
[ @EndTime = ] 'end_time'
這是所需期間的結束日期和時間 (以 UTC 為單位)。end_time 是 datetime,沒有預設值。您不能指定在 start_time 值之後,超出 24 小時的 end_time 值。
傳回碼值
無
結果集
NSScheduledSubscriptionDetails 結果集是依照 ScheduleTime 來排序。
資料行名稱 | 資料類型 | 描述 |
---|---|---|
SubscriptionId |
bigint |
已排程之訂閱的唯一識別碼。 |
SubscriberId |
nvarchar(255) |
擁有訂閱之訂閱者的唯一識別碼。 |
CreationDate |
datetime |
建立訂閱的日期和時間 (以 UTC 為單位)。 |
UpdateDate |
datetime |
上次更新訂閱的日期和時間 (以 UTC 為單位)。 |
Enabled |
bit |
指出目前是否啟用訂閱。1 值表示已啟用訂閱。 |
ScheduleTime |
datetime |
排程處理訂閱的日期和時間 (以 UTC 為單位)。 |
Subscription_Class_Field_Name |
定義的應用程式 |
符合應用程式定義檔案 (ADF) 所定義的訂閱類別欄位名稱。訂閱類別中的每個欄位都由結果集中的資料行來表示。 |
備註
當您建立執行個體時,Notification Services 會在應用程式資料庫中,建立 NSScheduledSubscriptionDetails 預存程序。當您更新應用程式時,Notification Services 會重新編譯預存程序。
這個預存程序在應用程式定義檔案 (ADF) 的 SchemaName 元素所指定的應用程式結構描述中。如果未提供結構描述名稱,預設結構描述便是 dbo。
若要判斷目前的 UTC 日期和時間,請在 SQL Server Management Studio 中執行 SELECT GETUTCDATE()。目前 UTC 時間是從目前本機時間和執行 SQL Server 的電腦作業系統時區設定衍生而來。
權限
執行權限預設會授與 NSAnalysis 和 db_owner 資料庫角色以及系統管理員 (sysadmin) 固定伺服器角色的成員。
範例
下列範例會顯示如何針對 Stock 應用程式之 PortfolioSubscriptions 訂閱類別來產生已排程之訂閱的報表。這份報表包含排程在 2004 年 5 月 23 日執行之訂閱的相關資訊,使用 UTC 時間值。
應用程式使用預設的 SchemaName 設定,這項設定會將所有應用程式物件放在 dbo 結構描述中。
EXEC dbo.NSScheduledSubscriptionDetails
@SubscriptionClassName = N'PortfolioSubscriptions',
@StartTime = '2004-05-23 00:00:00',
@EndTime = '2004-05-23 23:59:59';
請參閱
參考
Notification Services 預存程序 (Transact-SQL)
其他資源
Notification Services 效能報告
SchemaName Element (ADF)