Condividi tramite


NSEventSubmitBatch<EventClassName> (Transact-SQL)

Crea un nuovo evento batch, ottiene un set di eventi da una query e quindi inoltra tali eventi, facoltativamente esegue una query di post-elaborazione e quindi chiude il batch di eventi. Utilizzando una query come origine degli eventi è possibile inviare più eventi contemporaneamente, a differenza di quanto avviene con la stored procedure NSEventWriteEventClassName.

Sintassi

[ schema_name . ] SEventSubmitBatchEventClassName
    [ @ProviderName = ] 'event_provider_name',
    [ @EventsQuery = ] 'selection_query',
    [ @PostQuery = ] 'post_processing_query' 

Argomenti

[ @ProviderName = ] 'provider_name'

Nome del provider di eventi che inoltra gli eventi. provider_name è di tipo nvarchar(255) e deve essere uno dei provider di eventi specificati nel file di definizione dell'applicazione (ADF).

[ @EventsQuery = ] 'selection_query'

Testo della query Transact-SQL utilizzata per selezionare i record da inoltrare come eventi. Lo schema dei record generati dalla query deve corrispondere allo schema della tabella degli eventi alla quale vengono inoltrati. selection_query è di tipo nvarchar(4000).

[ @PostQuery = ] 'post_processing_query'

Testo di una query Transact-SQL utilizzata per eseguire qualsiasi operazione di eliminazione dei dati temporanei post-elaborazione o di manutenzione dello stato, come ad esempio l'aggiornamento delle tabelle della cronologia o l'eliminazione degli oggetti temporanei. post_processing_query è di tipo nvarchar(4000).

Set di risultati

Nome colonna Tipo di dati Descrizione

EventCount

bigint

Numero di eventi inoltrati nel batch di eventi. Questo numero viene ottenuto eseguendo una query sulla tabella degli eventi.

Osservazioni

Microsoft SQL Server Notification Services crea la stored procedure NSEventSubmitBatchEventClassName nel database dell'applicazione quando viene creata l'istanza. 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.

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 l'utilizzo della stored procedure NSEventSubmitBatchStockEvents per ottenere i nomi e le quotazioni delle azioni dalla tabella Stocks del database Market e quindi scrivere i dati nella tabella NSStockEventsEvents. La query specifica una query di post-elaborazione vuota.

L'applicazione utilizza le impostazioni predefinite di SchemaName, che prevedono l'inserimento di tutti gli oggetti dell'applicazione nello schema dbo.

EXEC dbo.NSEventSubmitBatchStockEvents
    @ProviderName = N'StockEP', 
    @EventsQuery = 'SELECT StockSymbol, StockPrice 
                    FROM Market.dbo.Stocks', 
    @PostQuery = '';

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