NSEventBeginBatch<EventClassName> (Transact-SQL)
Crea un nuevo lote de eventos para una aplicación de Microsoft SQL Server Notification Services. Normalmente, este procedimiento almacenado se utiliza para abrir un nuevo lote de eventos que permita enviar eventos individuales utilizando Transact-SQL. Vea la sección Notas para obtener más información.
Sintaxis
[ schema_name . ] NSEventBeginBatchEventClassName
[ @ProviderName = ] 'event_provider_name',
[ @EventBatchId = ] event_batch_variable OUTPUT
Argumentos
[ @ProviderName =] 'event_provider_name'
Es el nombre del proveedor de eventos que envía los eventos. event_provider_name es de tipo nvarchar(255) y no tiene ningún valor predeterminado.
[ @EventBatchId =] event_batch_variable OUTPUT
Es el número de identificación asignado al lote de eventos si el lote se crea correctamente. event_batch_variable es una variable de salida de tipo bigint y no tiene ningún valor predeterminado.
Conjuntos de resultados
| Nombre de columna | Tipo de datos | Descripción |
|---|---|---|
EventBatch |
Bigint |
Id. creado para el nuevo lote de eventos. |
Notas
Notification Services crea el procedimiento almacenado NSEventBeginBatchEventClassName en la base de datos de aplicación al crear la instancia. Al actualizar la aplicación, Notification Services vuelve a compilar el procedimiento almacenado.
Este procedimiento almacenado se encuentra en el esquema de la aplicación, que se especifica mediante el elemento SchemaName del archivo de definición de aplicación (ADF). Si no se proporciona ningún nombre de esquema, el esquema predeterminado es dbo.
Para enviar eventos individuales a una aplicación mediante Transact-SQL, use NSEventBeginBatchEventClassName para abrir el lote, NSEventWriteEventClassName para escribir eventos individuales y NSEventFlushBatchEventClassName para cerrar el lote de eventos.
Para utilizar una consulta con el fin de obtener un conjunto de eventos y enviarlos a una aplicación, utilice NSEventSubmitBatchEventClassName.
Permisos
De forma predeterminada, los permisos de ejecución corresponden a los miembros de las funciones de base de datos NSEventProvider y NSRunService, la función fija de base de datos db_owner y la función fija de servidor sysadmin.
Valores de código de retorno
0 (correcto) o 1 (error)
Ejemplos
El ejemplo siguiente muestra cómo iniciar un lote de eventos, escribir un evento y cerrar el lote de eventos. El proveedor de eventos del lote de eventos es StockEP y el número de identificación del lote de eventos se devuelve en el parámetro de salida @BatchID.
La aplicación utiliza la configuración predeterminada de SchemaName, que coloca todos los objetos de la aplicación en el esquema 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';
Este ejemplo presupone que está utilizando SQL Server Management Studio porque el Id. del lote de eventos se devuelve en la instrucción SELECT de forma que pueda ver el lote de eventos creado.
Vea también
Referencia
Procedimientos almacenados de Notification Services (Transact-SQL)
Otros recursos
Informes de rendimiento de Notification Services
SchemaName Element (ADF)