NSNotificationBatchDetails (Transact-SQL)

更新： 2006 年 4 月 14 日

產生 Microsoft SQL Server Notification Services 應用程式的通知批次詳細資料報表。這份報表包含指定通知批次的相關資訊，如產生批次的規則引發和批次所包含的通知。請利用這個預存程序來進行產生通知的疑難排解，以及分析應用程式的通知進程。

語法

[ application_schema_name . ] NSNotificationBatchDetails 
    [ @NotificationClassName = ] 'notification_class_name',
    [ @NotificationBatchId = ] notification_batch_id

引數

• [ @NotificationClassName = ] 'notification_class_name'
  這是通知類別的名稱。notification_class_name 是 nvarchar(255)，沒有預設值。

• [ @NotificationBatchId = ] notification_batch_id
  這是用來識別通知批次的唯一識別碼。notification_batch_id 是 bigint，沒有預設值。

傳回碼值

無

結果集

NSNotificationBatchDetails 會產生三個結果集。第一個結果集提供通知批次的一般資訊。

資料行名稱	資料類型	描述
RuleFiringId	int	產生通知批次之規則引發的唯一識別碼。
StartGenerationTime	datetime	產生通知批次的開始日期和時間，以國際標準時間 (UTC) 或格林威治標準時間 (GMT) 表示。
EndGenerationTime	datetime	產生通知批次的結束日期和時間 (以 UTC 為單位)。
GenerationTimeInMS	int	通知批次產生完成的時間 (以毫秒為單位)。
NotificationBatchExpirationTime	datetime	通知批次到期的日期和時間 (以 UTC 為單位)。到期時間過了之後，會放棄任何尚未傳遞的通知。不論重試的排程為何，都不會再嘗試傳遞這些通知。如果這個值是 NULL，批次就沒有到期時間。
NotificationCount	int	通知批次中的通知數目。
StatusDescription	nvarchar(255)	通知批次目前的狀態。

第二個結果集提供批次中的通知如何透過執行個體的各個傳遞通道來散發的相關資訊。

資料行名稱	資料類型	描述
DeliveryChannelName	nvarchar(255)	傳遞通道的名稱。
LastDistributionStartTime	datetime	前次散發者利用這個傳遞通道來開始從這個通知批次傳遞通知。
NotificationsWithNoDeliveryAttempt	int	散發者尚未利用這個傳遞通道，從這個通知批次中傳遞的通知數目。
NotificationsSuccessfullyDelivered	int	已利用這個傳遞通道，從這個通知批次中傳遞成功的通知數目。
NotificationsFailedToDeliver	int	這個傳遞通道從這個通知批次中傳遞失敗的通知數目。
RetryCount	int	散發者已取出通知批次以利用這個傳遞通道來傳遞的次數。
NextRetryTime	datetime	散發者下次嘗試利用這個傳遞通道從這個通知批次傳遞通知的時間。

第三個結果集提供通知批次中之通知的詳細資訊。

資料行名稱	資料類型	描述
NotificationId	bigint	通知批次內的通知識別碼。
SubscriberId	nvarchar(255)	通知的訂閱者識別碼。
DeviceName	nvarchar(255)	通知的訂閱者裝置名稱。
SubscriberLocale	nvarchar(10)	通知的地區設定名稱。
DeliveryStatus	nvarchar(255)	通知目前傳遞狀態的描述。
SentTime	datetime	前次嘗試傳遞通知完成的日期和時間 (以 UTC 為單位)。如果這個值是 NULL，就表示尚未嘗試傳遞通知，或傳遞通知尚未完成。
LinkedParentNotification	bigint	如果已在摘要或多重播送訊息中傳送通知，便是摘要或多重播送群組中的標頭通知識別碼。
DeliveryChannel	nvarchar(255)	傳送通知的傳遞通道名稱。
DeliveryAttempts	int	通知的傳遞嘗試次數。
Notification_class_field_name	定義的應用程式	這是符合應用程式定義檔案 (ADF) 所定義的通知類別欄位名稱。通知類別中的每個欄位都由結果集中的資料行來表示。

備註

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

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

權限

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

範例

這個範例會針對 StockNotifications 通知類別的通知批次 1，產生此章節先前所指定的三個結果集：

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

EXEC dbo.NSNotificationBatchDetails 
    @NotificationClassName = N'StockNotifications', 
    @NotificationBatchId = 1;

請參閱

參考

Notification Services 預存程序 (Transact-SQL)

其他資源

Notification Services 效能報告
SchemaName Element (ADF)

說明及資訊

取得 SQL Server 2005 協助

變更歷程記錄

版本	歷程記錄
2006 年 4 月 14 日	變更的內容： 修正第二個結果集中的資料行描述。