NSEventBeginBatch<EventClassName> (Transact-SQL)
Crée un nouveau lot d'événements pour une application Microsoft SQL Server Notification Services. Cette procédure stockée sert généralement à ouvrir un nouveau lot d'événements de façon à pouvoir soumettre des événements individuels à l'aide de Transact-SQL. Pour plus d'informations, voir la section des notes.
Syntaxe
[ schema_name . ] NSEventBeginBatchEventClassName
[ @ProviderName = ] 'event_provider_name',
[ @EventBatchId = ] event_batch_variable OUTPUT
Arguments
[ @ProviderName =] 'event_provider_name'
Nom du fournisseur d'événements qui soumet les événements. event_provider_name est de type nvarchar(255) et n'a pas de valeur par défaut.
[ @EventBatchId =] event_batch_variable OUTPUT
Numéro d'identification attribué au lot d'événements en cas de création réussie. event_batch_variable est une variable de sortie de type bigint et n'a pas de valeur par défaut.
Jeux de résultats
| Nom de colonne | Type de données | Description |
|---|---|---|
EventBatch |
Bigint |
ID attribué au nouveau lot d'événements. |
Notes
Notification Services crée la procédure stockée NSEventBeginBatchEventClassName dans la base de données d'application lors de la création de l'instance. Lors de la mise à jour de l'application, Notification Services recompile la procédure stockée.
Cette procédure stockée se trouve dans le schéma de l'application, qui est spécifié par l'élément SchemaName du fichier ADF (fichier de définition de l'application). Si aucun nom de schéma n'est précisé, le schéma par défaut est dbo.
Pour soumettre des événements individuels à une application à l'aide de 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 lancer une requête dans le but d'obtenir une série d'événements, puis de soumettre les événements à une application, utilisez NSEventSubmitBatchEventClassName.
Autorisations
Les autorisations d'exécution sont attribuées par défaut aux membres des rôles de base de données NSEventProvider et NSRunService, au rôle de base de données fixe db_owner et au rôle de serveur fixe sysadmin.
Valeurs des codes renvoyés
0 (succès) ou 1 (échec)
Exemple
L'exemple suivant montre comment commencer un lot d'événements, écrire un événement, puis fermer le lot d'événements Le fournisseur d'événements du lot d'événements est StockEP et le numéro d'identification du lot d'événements est renvoyé dans le paramètres de sortie @BatchID.
L'application utilise le paramètre SchemaName par défaut afin de placer 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';
Cet exemple part du principe que vous utilisez SQL Server Management Studio puisque l'ID du lot d'événements est renvoyé dans l'instruction SELECT de façon à vous laisser repérer le lot d'événements qui 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)