NSEventBeginBatch<EventClassName> (Transact-SQL)

Crea un nuovo batch di eventi per un'applicazione di Microsoft SQL Server Notification Services. Questa stored procedure viene in genere utilizzata per aprire un nuovo batch di eventi per inoltrare singoli eventi tramite Transact-SQL. Per ulteriori informazioni, vedere la sezione Osservazioni.

Sintassi

[ schema_name . ] NSEventBeginBatchEventClassName
    [ @ProviderName = ] 'event_provider_name',
    [ @EventBatchId = ] event_batch_variable OUTPUT

Argomenti

[ @ProviderName =] 'event_provider_name'

Nome del provider di eventi che inoltra gli eventi. event_provider_name è di tipo nvarchar(255) e non prevede alcun valore predefinito.

[ @EventBatchId =] event_batch_variable OUTPUT

Numero di identificazione del batch di eventi assegnato al batch di eventi se il batch è stato creato correttamente. event_batch_variable è una variabile di output di tipo bigint e non prevede alcun valore predefinito.

Set di risultati

Osservazioni

Quando viene creata l'istanza, Notification Services crea la stored procedure NSEventBeginBatchEventClassName nel database dell'applicazione. Quando si aggiorna l'applicazione, Notification Services ricompila la stored procedure.

Questa stored procedure è disponibile nello schema dell'applicazione, specificato dall'elemento SchemaName del file di definizione dell'applicazione (ADF). Se non si specifica un nome di schema, viene utilizzato lo schema predefinito dbo.

Per inoltrare singoli eventi a un'applicazione tramite Transact-SQL, utilizzare NSEventBeginBatchEventClassName per aprire il batch, NSEventWriteEventClassName per scrivere i singoli eventi e NSEventFlushBatchEventClassName per chiudere il batch di eventi.

Se si desidera eseguire una query per ottenere un set di eventi e quindi inviarli a un'applicazione, utilizzare NSEventSubmitBatchEventClassName.

Autorizzazioni

Le autorizzazioni di esecuzione vengono assegnate per impostazione predefinita ai membri dei ruoli di database NSEventProvider e NSRunService, del ruolo predefinito del database db_owner e del ruolo predefinito del server sysadmin.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Esempi

Nell'esempio seguente viene illustrato come iniziare un batch di eventi, scrivere un evento e quindi chiudere il batch di eventi. Il provider di eventi per il batch di eventi è StockEP e il numero di identificazione del batch di eventi viene restituito nel parametro di output @BatchID.

L'applicazione utilizza le impostazioni predefinite di SchemaName, che prevedono l'inserimento di tutti gli oggetti dell'applicazione nello schema 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';

In questo esempio si presuppone l'utilizzo di SQL Server Management Studio poiché l'ID del batch di eventi viene restituito nell'istruzione SELECT, consentendo di vedere quale batch di eventi è stato creato.

Vedere anche

Riferimento

Stored procedure di Notification Services (Transact-SQL)

Altre risorse

Report sulle prestazioni di Notification Services
SchemaName Element (ADF)

Guida in linea e informazioni

Assistenza su SQL Server 2005