NSEventBeginBatch<EventClassName> (Transact-SQL)
Microsoft SQL Server Notification Services アプリケーションに対して、新しいイベント バッチを生成します。基本的にこのストアド プロシージャは、Transact-SQL を使用してイベントを個別に送信できるように、新しいイベント バッチを開始する場合に使用します。詳細については、「解説」を参照してください。
構文
[ schema_name . ] NSEventBeginBatchEventClassName
[ @ProviderName = ] 'event_provider_name',
[ @EventBatchId = ] event_batch_variable OUTPUT
引数
[ @ProviderName =] 'event_provider_name'
イベントを送信しているイベント プロバイダの名前を指定します。event_provider_name のデータ型は nvarchar(255) で、既定値はありません。
[ @EventBatchId =] event_batch_variable OUTPUT
イベント バッチ (正常に作成された場合) に割り当てるイベント バッチ ID 番号です。event_batch_variable は出力変数で、データ型は bigint で、既定値はありません。
結果セット
| 列名 | データ型 | 説明 |
|---|---|---|
EventBatch |
Bigint |
新しいイベント バッチに対して作成されたイベント バッチ ID |
解説
Notification Services でインスタンスを作成すると、アプリケーション データベース内に NSEventBeginBatchEventClassName ストアド プロシージャが生成されます。アプリケーションを更新すると、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';
この例では、SQL Server Management Studio を使用していることを想定しています。イベント バッチの ID は最後の SELECT ステートメントで返されるので、どのイベント バッチが作成されたかを画面で確認できます。
参照
関連項目
Notification Services ストアド プロシージャ (Transact-SQL)
その他の技術情報
Notification Services パフォーマンス レポート
SchemaName 要素 (ADF)