次の方法で共有


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)

ヘルプおよび情報

SQL Server 2005 の参考資料の入手