Définition des règles de chronique d'événements

Les règles de chronique d'événements conservent les données dans les tables de chroniques d'événements. Chaque chronique d'événements a un nom, une action et un délai d'action.

Nom de règle

Le nom d'une règle de chronique d'événements identifie de manière unique la règle dans l'application Notification Services. Le nom de règle est utilisé pour nommer les objets de base de données. Pour des raisons de cohérence, le nom de chronique d'événement doit correspondre au nom de la table de chroniques d'événements.

Action

L'action contient le code qui gère les données dans les tables de chroniques, en conservant les données dans un état utilisable pour votre application. Par exemple, à chaque traitement d'un nouveau lot d'événements, les instructions contenues dans l'action peuvent supprimer toutes les données existantes d'une table de chroniques d'événements, puis insérer les nouvelles données d'événements.

Les instructions de l'action peuvent être une ou plusieurs requêtes Transact-SQL ou une instruction Transact-SQL EXECUTE qui exécute une procédure stockée.

Les instructions d'action s'exécutent à chaque fois que le générateur traite un lot d'événements. Elles se terminent avant que le générateur exécute les règles d'abonnement qui génèrent la notification. Ainsi, la chronique d'événements est mise à jour avant d'être utilisée pour générer les notifications.

Remarque :
Si vous souhaitez conserver les données de chronique après la génération des notifications, ajoutez des requêtes ou des appels de procédures stockées Transact-SQL aux règles d'événement d'abonnement. Pour plus d'informations, consultez Définition de règles d'événement.

Généralement, les instructions Transact-SQL de l'action sélectionnent les données d'une classe d'événement pour les insérer ou les mettre à jour dans la chronique d'événements. L'exemple suivant illustre des instructions Transact-SQL pour une action. Les instructions sélectionnent les nouvelles données de la classe d'événement StockEvents pour les insérer dans la chronique StockEventChron. Elles mettent ensuite à jour les cours de la Bourse pour les actions qui se trouvent déjà dans la chronique.

-- Insert New Stock Symbols with Prices
INSERT dbo.StockEventsChron (StockSymbol, StockPrice)
SELECT e.StockSymbol, e.StockPrice
    FROM dbo.StockEvents AS e
    WHERE e.StockSymbol
        NOT IN (SELECT StockSymbol FROM dbo.StockEventsChron);
-- Update Existing Stock Symbols with New Prices
UPDATE dbo.StockEventsChron
    SET StockPrice = e.StockPrice
    FROM dbo.StockEvents AS e 
    JOIN dbo.StockEventsChron AS c
        ON e.StockSymbol = c.StockSymbol
        WHERE e.StockPrice > c.StockPrice;

Remarque :
Si vous définissez une application dans un fichier XML, remplacez les caractères réservés XML, tels que '>', par leurs références d'entité. Pour plus d'informations, consultez XML Reserved Characters.

Toutes les instructions d'une action font partie de la même transaction. Elles sont toutes exécutées ou toutes annulées.

Pour plus d'informations sur la création de requêtes Transact-SQL, consultez Principes de base des requêtes.

Délai d'action

Le délai d'action spécifie la durée autorisée pour l'exécution des instructions de l'action. Si les instructions ne sont pas terminées avant l'expiration du délai, Notification System annule la transaction, marque la règle de chronique d'événements comme ayant échoué et écrit une erreur dans le journal des événements.

Remarque :
Si une règle de chronique d'événements échoue, signifiant qu'une erreur ou qu'une expiration de délai s'est produite lors de la gestion de la chronique d'événements, les règles d'événement d'abonnement associées supposées s'activer dans le même quantum de générateur échouent également. En revanche, les règles planifiées n'échoueront pas, car elles utilisent les données les plus récentes.

Pour définir une règle de chronique d'événements

• ChronicleRule Element (ADF)
• EventChronicleRule (NMO)

Exemples de règles de chroniques d'événements

Les rubriques suivantes fournissent des exemples de règles de chroniques d'événements.

• Exemple : Utilisation d'une chronique d'événements pour les abonnements planifiés
• Exemple : comparaison de données d'événements afin d'éviter les notifications en double
• Exemple : utilisation de valeurs de données d'événement élevées pour éviter les notifications en double

Voir aussi

Référence

EventChronicle
EventChronicleRule
EventFieldCollection

Concepts

Définition des principales propriétés de classe d'événement
Définition d'index pour une classe d'événements
Définition de règles d'événement

Autres ressources

Définition des classe d'événements
EventClass Element (ADF)
Définition des applications Notification Services
CREATE TABLE (Transact-SQL)
INSERT (Transact-SQL)
SELECT (Transact-SQL)
UPDATE (Transact-SQL)
DELETE (Transact-SQL)

Aide et Informations

Assistance sur SQL Server 2005