NSEventWrite<NomClasseÉvénements> (Transact-SQL)
Envoie un événement vers la table des événements correspondant à la classe d'événements. Vous devez utiliser NSEventBeginBatchNomClasseÉvénements pour ouvrir un nouveau lot et NSEventFlushBatchNomClasseÉvénements pour le refermer. Vous pouvez envoyer plusieurs événements avant de refermer le lot.
Syntaxe
[ schema_name . ] NSEventWriteEventClassName
[ @EventBatchId = ] event_batch_ID ,
[ @event_class_field_name = ] event_class_field_value [, ...n]
Arguments
[ @EventBatchId = ] event_ batch_ID
ID du lot d'événements pour cet événement. Le numéro d'identification du lot d'événements doit figurer dans la table des lots d'événements. L'argument event_batch_ID est de type bigint et n'a pas de valeur par défaut.
[ **@**event_class_field_name = ] event_class_field_value
Fournit une paire nom-valeur pour un champ de la classe d'événements. Une paire event_class_field_name et event_class_field_value peut être fournie pour chaque colonne de la table d'événements. Si la colonne contient une valeur par défaut ou si elle accepte la valeur NULL, la paire nom-valeur n'est pas nécessaire.
Valeurs des codes de retour
0 (succès) ou 1 (échec)
Notes
Microsoft SQL Server Notification Services crée la procédure stockée NSEventWriteNomClasseÉvénements dans la base de données de l'application 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 figure dans le schéma de l'application, lequel est spécifié par l'élément SchemaName du 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 envoyer des événements individuels à une application à l'aide de Transact-SQL, utilisez NSEventBeginBatchNomClasseÉvénements pour ouvrir le lot, NSEventWriteNomClasseÉvénements pour écrire des événements individuels, puis NSEventFlushBatchNomClasseÉvénements pour refermer le lot d'événements.
Pour utiliser une requête en vue d'obtenir un ensemble d'événements à envoyer à une application, utilisez NSEventSubmitBatchNomClasseÉvénements.
Autorisations
Les autorisations d'exécution sont octroyées par défaut aux membres des rôles de base de données NSEventProvider etNSRunService ainsi qu'aux membres du rôle de base de données fixe db_owner et du rôle de serveur fixe sysadmin.
Ensembles de résultats
Aucun
Exemples
L'exemple suivant montre comment ouvrir un lot d'événements, écrire un événement, puis refermer le lot d'événements. Le fournisseur d'événements du lot est StockEP et le numéro d'identification du lot est retourné dans le paramètre de sortie @BatchID.
L'application utilise les paramètres SchemaName par défaut, qui placent 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 suppose que vous utilisez SQL Server Management Studio car l'ID du lot d'événements est retourné dans l'instruction SELECT, permettant d'identifier 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)