NSQuantumDetails (Transact-SQL)

[アーティクル]
12/16/2008

クォンタムの詳細情報を返します。実行時間が長いクォンタムのトラブルシューティングを行うときや、クォンタムの処理内容を解析するときに、このストアドプロシージャを使用します。

構文

[ schema_name . ] NSQuantumDetails 
    [ @QuantumId = ] quantum_id

引数

[ @QuantumId = ] quantum_id
レポートの対象とするクォンタムの ID を指定します。quantum_id のデータ型は int で、既定値はありません。クォンタムの ID を取得するには、NSQuantumList、NSQuantumExecutionTime、NSQuantumFailures ストアドプロシージャのいずれかを使用します。

結果セット

NSQuantumDetails を実行すると、5 つの結果セットが返されます。1 番目の結果セットには、クォンタムの一般情報が含まれます。

列名	データ型	説明
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)	クォンタムの実行中にサブスクリプションルールの実行がスキップされたかどうか。

2 番目の結果セットには、クォンタムのルール実行に関する情報が含まれます。

列名	データ型	説明
RuleFiringId	int	クォンタムで実行されたルールの固有 ID。
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	ルールの実行中に処理されたイベントを含むイベントバッチの ID。ルール実行の種類が定期的なサブスクリプションの場合、または ADF 内の ProcessEventsInOrder の値が false の場合は、この列は NULL になります。これは、このルール実行が複数のイベントバッチを処理した可能性があるためです。
SubscriptionClassName	nvarchar(255)	ルールの実行中に処理されたサブスクリプションが属するサブスクリプションクラスの名前。ルール実行の種類がイベント記録の場合、この列には NULL が格納されます。
SubscriptionCount	bigint	ルールによって処理されたサブスクリプションの数の推定値。この値は、アプリケーションデータベース内の各サブスクリプションの現在の状態を基に推定されます。実際のルールの実行中は、データベースには、この値とは異なる数のサブスクリプションが含まれている場合もあります。
StartScanTime	datetime	ルールが使用した定期的なサブスクリプションの開始日時 (UTC)。この列には、ルールの種類が定期的なサブスクリプションで、アプリケーションがイベントを順番に処理するよう設定されている場合に限り、値が格納されます。
EndScanTime	datetime	ルールが使用した定期的なサブスクリプションの終了日時 (UTC)。この列には、ルールの種類が定期的なサブスクリプションで、アプリケーションがイベントを順番に処理するよう設定されている場合に限り、値が格納されます。
NotificationsGenerated	int	ルールの実行の結果生成された通知の数。

3 番目の結果セットには、クォンタムで収集されたイベントバッチに関する情報が含まれます。

列名	データ型	説明
EventClassName	nvarchar(255)	イベントバッチを送信したイベントクラスの名前。
EventBatchId	bigint	イベントバッチの ID。
EventCount	bigint	イベントバッチに含まれるイベントの数。
StartCollectionTime	datetime	イベントバッチの収集を開始した日時 (UTC)。
EndCollectionTime	datetime	イベントバッチの収集を終了した日時 (UTC)。
CollectionTimeInMS	int	イベントバッチの収集にかかった合計時間 (ミリ秒単位)。
ProviderName	nvarchar(255)	イベントバッチを送信したイベントプロバイダの名前。イベントが <EventClassName> ビューに直接挿入された場合、この値は NULL になります。
SystemName	nvarchar(255)	イベントプロバイダを実行しているシステムの名前。ホストされていないイベントプロバイダの場合、またはイベントが <EventClassName> ビューに直接挿入された場合、この値は NULL になります。

4 番目の結果セットには、クォンタムで処理されたサブスクリプションに関する情報が含まれます。

列名	データ型	説明
SubscriptionClassName	nvarchar(255)	クォンタムで処理されたサブスクリプションについて定義しているサブスクリプションクラスの名前。
EventSubscriptionCount	bigint	サブスクリプションクラスに属するサブスクリプションのうち、クォンタムでアクティブだったイベントベースのサブスクリプションの数に関する推定値。
ScheduledSubscriptionCount	bigint	サブスクリプションクラスに属するサブスクリプションのうち、クォンタムでアクティブだった定期的なサブスクリプションの数に関する推定値。

5 番目の結果セットには、クォンタムで生成された通知に関する情報が含まれます。

列名

データ型

説明

NotificationClassName

nvarchar(255)

バッチに含まれている通知が属する通知クラスの名前。

NotificationBatchId

bigint

クォンタムで実行されたルールの結果生成された通知バッチの一意 ID。

RuleFiringId

int

通知バッチを生成したルール実行の一意 ID。

NotificationCount

int

通知バッチに含まれている通知の数。

NotificationDeliveryAttempts

int

通知バッチから通知の配信を試行した回数。

ms186227.note(ja-jp,SQL.90).gif メモ :

通知が配信プロトコルに渡されても、配信プロトコルからそのステータスのレポートが返されなかった場合、この通知は配信の回数に含まれません。

NotificationSuccessfulDeliveries

int

通知バッチからの配信が成功した通知の数。

NotificationFailedAttempts

int

通知バッチからの配信が失敗した通知の数。

NotificationsDeliveryNotAttempted

int

ディストリビュータがまだ配信を試行していない通知の数。

NotificationsNotYetDelivered

int

ディストリビュータがまだ配信に成功していない通知の数。

NotificationToMessageRatio

float

生成された通知の数と送信されたメッセージの数の比率。

ダイジェスト配信またはマルチキャスト配信の場合、1 つのメッセージに複数の通知を含めることができます。この場合、この列の値は、ダイジェストメッセージまたはマルチキャストメッセージに含まれていた通知の数の平均値を表します。

AvgNotificationBatchSucceedDeliveryTime

float

配信処理で通知の送信成功までにかかった時間の平均値 (秒単位)。

解説

Notification Services でインスタンスを作成すると、アプリケーションデータベース内に NSQuantumDetails ストアドプロシージャが作成されます。アプリケーションを更新すると、Notification Services ではストアドプロシージャが再コンパイルされます。

このストアドプロシージャは、アプリケーション定義ファイル (ADF) の要素 SchemaName で指定される、アプリケーションスキーマ内に格納されます。スキーマ名が指定されない場合、既定のスキーマ dbo が使用されます。

クォンタムについて高レベルの詳細を取得した後、次のストアドプロシージャを使用してクォンタムをさらに調査することができます。

権限

実行権限は、既定では NSAnalysis データベースロール、db_owner データベースロール、および sysadmin 固定サーバーロールのメンバに与えられています。

戻り値

なし

例

次の例では、アプリケーションの 1 番目のジェネレータクォンタムを対象に、前述の 5 つの結果セットを生成します。

アプリケーションでは、既定の SchemaName 設定が使用されます。この設定ではすべてのアプリケーションオブジェクトが dbo スキーマに格納されます。

EXEC dbo.NSQuantumDetails 
    @QuantumId = 1;

参照

その他の技術情報

Notification Services パフォーマンスレポート
 SchemaName 要素 (ADF)

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

次の方法で共有

NSQuantumDetails (Transact-SQL)

構文

引数

結果セット

解説

権限

戻り値

例

参照

関連項目

その他の技術情報

ヘルプおよび情報

その他のリソース