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
這是建立事件批次成功時，指派給這個批次的事件批次識別碼。event_batch_variable 是 bigint 類型的輸出變數，沒有預設值。
傳回碼值
0 (成功) 或 1 (失敗)
結果集
| 資料行名稱 | 資料類型 | 描述 |
|---|---|---|
EventBatch |
Bigint |
為了新事件批次而建立的事件批次識別碼。 |
備註
當您建立執行個體時，Notification Services 會在應用程式資料庫中，建立 NSEventBeginBatchEventClassName 預存程序。當您更新應用程式時，Notification Services 會重新編譯預存程序。
這個預存程序在應用程式定義檔案 (ADF) 的 SchemaName 元素所指定的應用程式結構描述中。如果未提供結構描述名稱，預設結構描述便是 dbo。
若要利用 Transact-SQL 將個別事件提交給應用程式，請利用 NSEventBeginBatchEventClassName 來開啟批次，利用 NSEventWriteEventClassName 來寫入個別事件，利用 NSEventFlushBatchEventClassName 來關閉事件批次。
若要利用查詢來取得一組事件，再將它們提供給應用程式，請使用 NSEventSubmitBatchEventClassName。
權限
執行權限預設會授與 NSEventProvider 和 NSRunService 資料庫角色、db_owner 固定資料庫角色以及系統管理員 (sysadmin) 固定伺服器角色的成員。
範例
下列範例會顯示如何起始事件批次、寫入事件，再關閉事件批次。事件批次的事件提供者是 StockIP，事件批次識別碼是在 @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，因為 SELECT 陳述式會傳回事件批次識別碼，因此，您可以看出建立了哪些事件批次。
請參閱
參考
Notification Services 預存程序 (Transact-SQL)
其他資源
Notification Services 效能報告
SchemaName Element (ADF)