NSEventFlushBatch<EventClassName> (Transact-SQL)

Ferme un lot d'événements ouvert par NSEventBeginBatchEventClassName. Cette procédure stockée valide la transaction de collection d'événements puis indique que le lot d'événements est terminé. Vous utilisez généralement cette procédure stockée si vous envoyez des événements individuels à l'aide de Transact-SQL. Pour plus d'informations, consultez la section des notes.

Syntaxe

[ schema_name . ] NSEventFlushBatchEventClassName
    [ @EventBatchId = ] event_batch_ID
    [, [@EventCount = ] number_of_events]

Arguments

[ @EventBatchId =] event_batch_ID

Numéro d'ID du lot d'événements à valider. L'argument event_batch_ID est de type bigint et ne possède pas de valeur par défaut.

[ @EventCount =] number_of_events

Représente le nombre d'événements envoyés pour le lot d'événements. La procédure stockée obtient la valeur par défaut en interrogeant la table d'événements.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Jeux de résultats

Notes

Notification Services crée la procédure stockée NSEventFlushBatchEventClassName dans la base de données des applications lorsque vous créez l'instance. Lorsque vous mettez à jour l'application, Notification Services recompile la procédure stockée.

Cette procédure stockée se trouve dans le schéma de l'application, spécifié par l'élément SchemaName du fichier de définition d'application. Si aucun nom de schéma n'est spécifié, le schéma par défaut est dbo.

Pour envoyer des événements individuels vers une application utilisant Transact-SQL, utilisez NSEventBeginBatchEventClassName pour ouvrir le lot, NSEventWriteEventClassName pour écrire des événements individuels et NSEventFlushBatchEventClassName pour fermer le lot d'événements.

Pour utiliser une requête afin d'obtenir un ensemble d'événements, puis les envoyer vers une application, utilisez NSEventSubmitBatchEventClassName.

Autorisations

Les autorisations d'exécution reviennent par défaut aux membres des rôles de base de données NSEventProvider et NSRunService, le rôle de base de données fixe db_owner et celui de serveur fixe sysadmin.

Exemples

L'exemple suivant illustre comment démarrer un lot d'événements, écrire un événement puis fermer le lot d'événements. Le fournisseur d'événement du lot d'événements est StockEP, tandis que le numéro d'ID de lot d'événements est renvoyé dans le paramètre de sortie @BatchID.

L'application utilise les paramètres SchemaName par défaut, qui place tous les objets d'application dans le schéma 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';

Dans cet exemple, nous considérons que vous utilisez Microsoft SQL Server Management Studio car l'ID de lot d'événements est renvoyé dans l'instruction SELECT, afin que vous puissiez savoir quel événement a été créé.

Voir aussi

Référence

Procédures stockées de Notification Services (Transact-SQL)

Autres ressources

Rapports de performances de Notification Services
SchemaName Element (ADF)

Aide et Informations

Assistance sur SQL Server 2005