次の方法で共有


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)

ヘルプおよび情報

SQL Server 2005 の参考資料の入手