Le test d'événement SQL défini par l'utilisateur vous permet de définir votre propre script SQL pour évaluer un test d'événement. Vous devez écrire les tests d'événement que vous définissez comme des interrogations (c'estàdire comme des instructions SELECT) retournant les valeurs de condition que vous surveillez. Ces valeurs sont vérifiées par rapport aux limites de seuil d'alerte et d'avertissement spécifiées, et déclenchent l'événement si les limites de seuil sont atteintes.
Exemple :
Vous disposez d'une application personnalisée qui fonctionne avec la base de donnée Oracle. Dès qu'elle détecte une erreur d'application, elle crée une entrée dans la table
error_log. Le test d'événement SQL défini par l'utilisateur vous permet d'écrire un test d'événement vous avertissant lorsqu'il détecte au moins 50 erreurs. Plus précisément, vous définissez l'instruction SQL suivante :
select count(*) from error_log
Cette instruction renvoie le nombre de lignes de la table error_log. Vous voulez générer une alerte lorsque le seuil de 50 est atteint : utilisez l'opérateur >= , une valeur d'alerte de 50, et, éventuellement, une valeur d'avertissement de 30.
Prise en charge des fonctions PL/SQL
Si l'interrogation de la condition d'événement entraîne l'utilisation d'un traitement plus complexe que ne le permet une seule instruction SELECT, vous pouvez créer une fonction PL/SQL contenant les étapes de traitement supplémentaires, puis utiliser cette fonction avec le test d'événement SQL défini par l'utilisateur. La fonction PL/SQL doit toujours retourner une valeur pouvant être comparée aux seuils d'alerte et d'avertissement.
Exemple :
Vous devez déclencher une alerte dès que
le montant du salaire d'un employé dépasse de 500 dollars (3 500 francs environ) le salaire le plus élevé d'un directeur. Définissez d'abord une fonction PL/SQL comme suit :
create or replace function overpaid_emp return number is
max_mgr_sal number;
max_emp_sal number;
begin
select max(sal) into max_mgr_sal from scott.emp where job = 'MANAGER' or job = 'PRESIDENT';
select max(sal) into max_emp_sal from scott.emp where job != 'MANAGER' and job != 'PRESIDENT';
return (max_emp_sal - max_mgr_sal);
end;
Cette fonction PL/SQL renvoie la différence entre le salaire maximal d'un employé et le salaire maximal d'un directeur. Si le nombre obtenu est positif, le salaire de l'employé est le plus élevé. Si la différence est supérieure à 500, une alerte doit être déclenchée.
Lorsque vous définissez cet événement via un test d'événement SQL défini par l'utilisateur, vous définissez l'instruction SQL comme suit :
select overpaid_emp from dual
Utilisez l'Opérateur >, un seuil d'avertissement de 100 et un seuil d'alerte de 500.
Le paramètre ROLES n'étant pas activé dans les fonctions PL/SQL, les privilèges accordés via ce paramètre ne fonctionneront pas dans la fonction. Vous devrez peutêtre accorder directement les privilèges au compte utilisateur de la base de données utilisée pour l'événement. (Ce dernier est l'utilisateur indiqué dans les informations d'identification et de connexion de la base de données, ou les informations d'identification et de connexion indiquées comme prioritaires.)
Paramètres
· Passer outre aux éléments d'identification : cochez cette case si vous voulez modifier le nom utilisateur, le mot de passe ou les deux.
· Opérateur : sélectionnez l'un des opérateurs de comparaison suivants : == (égal) ; < (inférieur à) ; > (supérieur à) ; <= (inférieur ou égal à) ; >= (supérieur ou égal à) ; != (différent de)
· Seuil d'alerte : selon le script SQL choisi, entrez un nombre ou une chaîne de texte.
· Seuil d'avertissement : selon le script SQL choisi, entrez un nombre ou une chaîne de texte.
· Nombre d'occurrences avant notification : entrez une valeur numérique indiquant le nombre de fois où ce test doit renvoyer la valeur True avant qu'un indicateur d'alerte apparaisse dans la console et qu'une notification soit envoyée.
· SQL : entrez le script SQL à utiliser. Vous pouvez aussi couper et coller des instructions SQL depuis un script existant.
Sortie
Valeur renvoyée par le script SQL
Fréquence par défaut
60 secondes
Action utilisateur
L'action dépend du script SQL ; par conséquent, Oracle ne peut générer aucune recommandation.