NSEventFlushBatch<EventClassName> (Transact-SQL)
NSEventBeginBatchEventClassName によって開始されたイベント バッチを終了します。このストアド プロシージャを実行すると、イベント収集のトランザクションがコミットされ、イベント バッチが完了したものとしてマークされます。基本的にこのストアド プロシージャは、Transact-SQL を使用してイベントを個別に送信する場合に使用します。詳細については、「解説」を参照してください。
構文
[ schema_name . ] NSEventFlushBatchEventClassName
[ @EventBatchId = ] event_batch_ID
[, [@EventCount = ] number_of_events]
引数
[ @EventBatchId =] event_batch_ID
コミットするイベント バッチの ID 番号を指定します。event_batch_ID のデータ型は bigint で、既定値はありません。
[ @EventCount =] number_of_events
イベント バッチで送信されたイベントの数を指定します。既定値は、イベント テーブルにクエリを実行して取得される値になります。
結果セット
列名 | データ型 | 説明 |
---|---|---|
EventCount |
bigint |
イベント バッチで送信されたイベントの数。この数は、@EventCount 引数に指定した値か、イベント テーブルにクエリを実行して取得した値です。 |
解説
Notification Services でインスタンスを作成すると、アプリケーション データベース内に NSEventFlushBatchEventClassName ストアド プロシージャが作成されます。アプリケーションを更新すると、Notification Services ではストアド プロシージャが再コンパイルされます。
このストアド プロシージャは、アプリケーション定義ファイル (ADF) の要素 SchemaName で指定される、アプリケーション スキーマ内に格納されます。スキーマ名が指定されない場合、既定のスキーマ dbo が使用されます。
Transact-SQL を使用して個々のイベントをアプリケーションに送信するには、NSEventBeginBatchEventClassName を使用してバッチを開始し、NSEventWriteEventClassName を使用して個々のイベントを書き込み、NSEventFlushBatchEventClassName を使用してイベント バッチを終了します。
クエリを使用して複数のイベントを取得した後、それらをまとめてアプリケーションに送信する場合は、NSEventSubmitBatchEventClassName を使用します。
権限
既定では、NSEventProvider データベース ロール、NSRunService データベース ロール、db_owner 固定データベース ロール、および sysadmin 固定サーバー ロールのメンバに実行権限が与えられています。
戻り値
0 (成功) または 1 (失敗)
例
次の例では、イベント バッチを開始し、1 つのイベントを書き込んだ後、イベント バッチを終了します。このイベント バッチのイベント プロバイダは StockEP で、イベント バッチの ID 番号は @BatchID 出力パラメータに返されます。
アプリケーションでは、既定の SchemaName 設定が使用されます。この設定では、すべてのアプリケーション オブジェクトが dbo スキーマに格納されます。
DECLARE @BatchID bigint;
EXEC dbo.NSEventBeginBatchStockEvents N'StockEP', @BatchID OUTPUT;
EXEC dbo.NSEventWriteStockEvents
@EventBatchId=@BatchID,
@StockSymbol=N'AWKS',
@StockPrice=68.14;
EXEC dbo.NSEventFlushBatchStockEvents @BatchID;
SELECT @BatchID 'Event Batch';
この例では、Microsoft SQL Server Management Studio を使用していることを想定しています。イベント バッチの ID は最後の SELECT ステートメントで返されるので、どのイベント バッチが作成されたかを画面で確認できます。
参照
関連項目
Notification Services ストアド プロシージャ (Transact-SQL)
その他の技術情報
Notification Services パフォーマンス レポート
SchemaName 要素 (ADF)