NSQuantumDetails (Transact-SQL)
傳回配量的詳細資訊。請利用這個預存程序來進行長期執行之配量的疑難排解,或分析配量的處理。
語法
[ schema_name . ] NSQuantumDetails
[ @QuantumId = ] quantum_id
引數
- [ @QuantumId = ] quantum_id
這是報表的配量識別碼。quantum_id 是 int,沒有預設值。請利用 NSQuantumList、NSQuantumExecutionTime 和 NSQuantumFailures 預存程序來取得配量識別碼。
傳回碼值
無
結果集
NSQuantumDetails 會產生五個結果集。第一個結果集包含配量的一般資訊。
資料行名稱 | 資料類型 | 描述 |
---|---|---|
QuantumStartTime |
datetime |
配量所代表之時間間隔的開始時間 (以 UTC 為單位)。 |
QuantumEndTime |
datetime |
配量所代表之時間間隔的結束時間 (以 UTC 為單位);結束時間是開始時間加上配量期間。 |
QuantumStatusDescription |
nvarchar(255) |
描述配量目前狀態的文字。 |
ExecutionTimeInMS |
int |
完成配量處理的時間 (以毫秒為單位)。 |
ExecutionStartTime |
datetime |
產生器開始處理配量的實際日期和時間 (以 UTC 為單位)。 |
ExecutionEndTime |
datetime |
產生器處理完配量的實際日期和時間 (以 UTC 為單位)。 |
EventNotificationsGenerated |
bigint |
在配量執行期間,根據事件觸發規則產生的通知數目。 |
ScheduledNotificationsGenerated |
bigint |
在配量執行期間,根據排程的訂閱規則產生的通知數目。 |
ChronicleRuleFiringsSkipped |
nvarchar(255) |
指出在這個配量期間,是否略過了事件紀事輯規則的引發。 |
SubscriptionRuleFiringsSkipped |
nvarchar(255) |
指出在這個配量期間,是否略過了事件訂閱規則的引發。 |
第二個結果集包含配量規則引發的相關資訊。
資料行名稱 | 資料類型 | 描述 |
---|---|---|
RuleFiringId |
int |
配量期間所引發之規則的唯一識別碼。 |
RuleName |
nvarchar(255) |
這是符合應用程式定義檔案 (ADF) 所定義的規則名稱。 |
ExecutionTimeInMS |
int |
完成規則引發的時間 (以毫秒為單位)。 |
PercentageQuantumTime |
numeric(7, 4) |
用來引發規則的整體配量執行時間百分比。 |
ExecutionStartTime |
datetime |
規則引發的開始日期和時間 (以 UTC 為單位)。 |
ExecutionEndTime |
datetime |
規則引發的結束日期和時間 (以 UTC 為單位)。 |
RuleTypeDescription |
nvarchar(250) |
描述執行的規則類型;類型是事件紀事輯、事件訂閱,或排程的訂閱。 |
EventClassName |
nvarchar(255) |
規則引發期間所處理之事件的事件類別名稱。如果規則引發類型是已排程的訂閱,這個資料行就是 NULL,因為這些規則並不是事件觸發的規則。 |
EventCount |
bigint |
規則所處理的事件數目。 |
EventBatchId |
bigint |
包含規則引發期間所處理的事件之事件批次識別碼。如果規則引發類型是已排程的訂閱,或 ADF 中的 ProcessEventsInOrder 值是 false,這個資料行就是 NULL,因為規則引發可能已處理多個事件批次。 |
SubscriptionClassName |
nvarchar(255) |
規則引發期間所處理之訂閱的訂閱類別名稱。如果規則引發類型是事件紀事輯,這個資料行就是 NULL。 |
SubscriptionCount |
bigint |
規則所處理之訂閱的估計數目。這個值是根據應用程式資料庫中之訂閱目前的狀態來估計的。在實際的規則引發時間,資料庫包含的訂閱可能會較多,也可能會較少。 |
StartScanTime |
datetime |
規則所用的已排程之訂閱的開始日期和時間 (以 UTC 為單位)。只有在規則類型是已排程的訂閱,且應用程式會循序處理事件時,這個資料行才會包含值。 |
EndScanTime |
datetime |
規則所用的已排程之訂閱的結束日期和時間 (以 UTC 為單位)。只有在規則類型是已排程的訂閱,且應用程式會循序處理事件時,這個資料行才會包含值。 |
NotificationsGenerated |
int |
規則引發所產生的通知數目。 |
第三個結果集包含配量期間所收集之事件批次的相關資訊。
資料行名稱 | 資料類型 | 描述 |
---|---|---|
EventClassName |
nvarchar(255) |
提交事件批次之事件類別的名稱。 |
EventBatchId |
bigint |
事件批次的識別碼。 |
EventCount |
bigint |
事件批次中的事件數目。 |
StartCollectionTime |
datetime |
收集事件批次的開始日期和時間 (以 UTC 為單位)。 |
EndCollectionTime |
datetime |
收集事件批次的結束日期和時間 (以 UTC 為單位)。 |
CollectionTimeInMS |
int |
收集事件批次的總時間 (以毫秒為單位)。 |
ProviderName |
nvarchar(255) |
提交事件批次的事件提供者名稱。如果事件直接插入 <EventClassName> 檢視中,則此值為 NULL。 |
SystemName |
nvarchar(255) |
正在執行事件提供者的系統名稱。對於非主控的事件提供者,或如果事件直接插入 <EventClassName> 檢視中,則此值為 NULL。 |
第四個結果集包含配量期間所處理之訂閱的相關資訊。
資料行名稱 | 資料類型 | 描述 |
---|---|---|
SubscriptionClassName |
nvarchar(255) |
配量期間所處理之訂閱的訂閱類別名稱。 |
EventSubscriptionCount |
bigint |
在配量期間,訂閱類別的使用中事件觸發訂閱的估計數目。 |
ScheduledSubscriptionCount |
bigint |
在配量期間,訂閱類別的使用中排程訂閱的估計數目。 |
第五份報表包含配量期間所產生之通知的相關資訊。
資料行名稱
資料類型
描述
NotificationClassName
nvarchar(255)
批次中的通知所屬之通知類別的名稱。
NotificationBatchId
bigint
配量內的規則引發所產生之通知批次的唯一識別碼。
RuleFiringId
int
產生通知批次之規則引發的唯一識別碼。
NotificationCount
int
通知批次中的通知數目。
NotificationDeliveryAttempts
int
嘗試傳遞通知批次中之通知的次數。
附註:
如果通知已交給傳遞通訊協定,但傳遞通訊協定尚未回報它的狀態,這項通知就不列入嘗試的次數。
NotificationSuccessfulDeliveries
int
從通知批次中傳遞通知成功的數目。
NotificationFailedAttempts
int
從通知批次中傳遞通知失敗的數目。
NotificationsDeliveryNotAttempted
int
散發者尚未嘗試傳遞的通知數目。
NotificationsNotYetDelivered
int
散發者尚未傳遞成功的通知數目。
NotificationToMessageRatio
float
產生的通知與傳送之訊息的比例。
如果是摘要或多重傳遞,單一訊息可以包括多項通知。這個資料行指出摘要或多重播送訊息所包含的平均通知數。
AvgNotificationBatchSucceedDeliveryTime
float
透過散發程序傳送通知成功的平均時間 (以秒為單位)。
備註
當您建立執行個體時,Notification Services 會在應用程式資料庫中,建立 NSQuantumDetails 預存程序。當您更新應用程式時,Notification Services 會重新編譯預存程序。
這個預存程序在應用程式定義檔案 (ADF) 的 SchemaName 元素所指定的應用程式結構描述中。如果沒有提供結構描述名稱,預設結構描述便是 dbo。
在取得配量的高階詳細資料之後,您可以利用下列預存程序來進一步搜尋配量:
- NSEventBatchDetails (Transact-SQL)
- NSNotificationBatchDetails (Transact-SQL)
- NSScheduledSubscriptionDetails (Transact-SQL)
權限
執行權限預設會授與 NSAnalysis 和 db_owner 資料庫角色的成員,以及系統管理員 (sysadmin) 固定伺服器角色的成員。
範例
下列範例會針對應用程式的第一個產生器配量,產生此章節先前所列出的五個結果集:
應用程式使用預設的 SchemaName 設定,這項設定會將所有應用程式物件放在 dbo 結構描述中。
EXEC dbo.NSQuantumDetails
@QuantumId = 1;
請參閱
參考
Notification Services 預存程序 (Transact-SQL)
NSEventBatchDetails (Transact-SQL)
NSNotificationBatchDetails (Transact-SQL)
NSScheduledSubscriptionDetails (Transact-SQL)
其他資源
Notification Services 效能報告
SchemaName Element (ADF)