NSEventSubmitBatch<EventClassName> (Transact-SQL)

Crée un nouveau lot d'événements, obtient une série d'événements d'une requête et soumet ces événements, exécute éventuellement une requête de post-traitement, puis ferme le lot d'événements. En utilisant une requête comme source d'événement, vous pouvez soumettre plusieurs événements simultanément, ce que ne permet pas la procédure stockée NSEventWriteEventClassName.

Syntaxe

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

Arguments

[ @ProviderName = ] 'provider_name'

Nom du fournisseur d'événements qui soumet les événements. provider_name est de type nvarchar(255) et doit être l'un des fournisseurs d'événements spécifiés dans le fichier ADF (fichier de définition d'application).

[ @EventsQuery = ] 'selection_query'

Texte de la requête Transact-SQL qui sert à sélectionner les enregistrements à soumettre comme événements. Le schéma des enregistrements généré par la requête doit correspondre à celui de la table d'événements où ils sont soumis. selection_query est de type nvarchar(4000).

[ @PostQuery = ] 'post_processing_query'

Texte de la requête Transact-SQL utilisée pour procéder à un nettoyage de post-traitement ou à une maintenance d'état, comme la mise à jour des tables de chronique ou la suppression des objets temporaires. post_processing_query est de type nvarchar(4000).

Jeux de résultats

Notes

Microsoft SQL Server Notification Services crée la procédure stockée NSEventSubmitBatchEventClassName 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.

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 utiliser la procédure stockée NSEventSubmitBatchStockEvents pour extraire des noms et des tarifs de la table Stocks de la base de données Market, et comment écrire les données dans la table NSStockEventsEvents. La requête spécifie une requête de post-traitement vide.

L'application utilise le paramètre SchemaName par défaut afin de placer tous les objets d'application dans le schéma dbo.

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

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