Implémentation de notifications d'événements

Création du service cible

Il n'est pas nécessaire que vous créiez un service d'initialisation de Service Broker, car Service Broker inclut le type de message et le contrat de notifications d'événements suivants :

https://schemas.microsoft.com/SQL/Notifications/PostEventNotification

Le service cible qui reçoit les notifications d'événements doit respecter ce contrat préexistant.

Pour créer un serveur cible :

1. Créez une file d'attente pour recevoir les messages.

   Notes

   Cette file d'attente reçoit le type de message suivant : https://schemas.microsoft.com/SQL/Notifications/QueryNotification.

2. Créez un service dans la file d'attente qui fasse référence au contrat de notification d'événement.

3. Créez un itinéraire au niveau du service pour indiquer l'adresse à laquelle Service Broker doit expédier les messages pour le service. Si la notification d'événement a pour cible un service de la même base de données, spécifiez ADDRESS = 'LOCAL'.

   Notes

   L'acheminement de Service Broker désigne le service appelé à recevoir les messages de notification. Si votre notification d'événement a pour cible un service de serveur distant, il convient de définir des itinéraires à la fois sur le serveur source et sur le serveur cible pour éviter des erreurs de communication bidirectionnelle. Pour plus d'informations, consultez Routage Service Broker.

L'exemple suivant illustre la création d'une file d'attente, d'un service au niveau de cette file d'attente, et d'un itinéraire au niveau du service en vue de gérer les messages relevant du contrat de notification d'événement.

CREATE QUEUE NotifyQueue ;
GO
CREATE SERVICE NotifyService
ON QUEUE NotifyQueue
(
[https://schemas.microsoft.com/SQL/Notifications/PostEventNotification]
);
GO
CREATE ROUTE NotifyRoute
WITH SERVICE_NAME = 'NotifyService',
ADDRESS = 'LOCAL';
GO

Pour plus d'informations sur la création de services cibles Service Broker, consultez Avantages de la programmation avec Service Broker.

Création de la notification d'événement

Les notifications d'événements sont créées à l'aide de l'instruction Transact-SQL CREATE EVENT NOTIFICATION et supprimées à l'aide de l'instruction DROP EVENT NOTIFICATION. Pour modifier une notification d'événement, vous devez la supprimer et la recréer.

L'exemple suivant crée la notification d'événement CreateDatabaseNotification. Cette notification envoie un message à propos de tout événement CREATE_DATABASE qui se produit sur le serveur au service NotifyService précédemment créé.

CREATE EVENT NOTIFICATION CreateDatabaseNotification
ON SERVER
FOR CREATE_DATABASE
TO SERVICE 'NotifyService', '8140a771-3c4b-4479-8ac0-81008ab17984' ;

Attention

Les notifications d'événements reconnaissent les événements CREATE_SCHEMA et les définitions <schema_element> des instructions CREATE SCHEMA comme événements distincts. Par exemple, une notification d'événement est créée sur les deux événements CREATE_SCHEMA et CREATE_TABLE, et vous exécutez le traitement suivant. CREATE SCHEMA s CREATE TABLE t1 (col1 int) Dans ce cas, la notification d'événement est déclenchée deux fois : une première fois quand se produit l'événement CREATE_SCHEMA, et une deuxième fois quand se produit l'événement CREATE_TABLE. Nous recommandons d'éviter de créer des notifications d'événements sur les événements CREATE_SCHEMA et les textes <schema_element> des définitions CREATE SCHEMA correspondantes, ou de créer une logique dans votre application destinée à éviter la capture des données d'événement non souhaitées.

Pour créer une notification d'événement

• CREATE EVENT NOTIFICATION (Transact-SQL)

Pour supprimer une notification d'événement

• DROP EVENT NOTIFICATION (Transact-SQL)

Voir aussi

Référence

Concepts