ユーザー定義のSQLイベント・テストにより、イベント・テストを評価する独自のSQLスクリプトを定義することができます。定義するイベント・テストは、監視している状況の値を返す問合せ(SELECT文)として書きます。これらの値は、指定する警告および警戒しきい値制限に照合して調べられ、しきい値制限に達している場合、イベントをトリガーします。
例:
Oracleデータベースに対して実行されるカスタム・アプリケーションがあります。アプリケーション・エラーを発見するたびに、アプリケーションでは、
error_logという表にエントリを作成します。「ユーザー定義のSQLテスト」を使用すると、最低50個のエラーが発見された場合に知らせるイベント・テストを作成できます。具体的には、次のSQL文を定義します。
select count(*) from error_log
この文により、error_log表内の行数が返されます。行数が最低50に達した場合、警告が通知されるようにするには、演算子に">="、警告の値には50、警戒の値には30を指定します。
PL/SQLファンクションのサポート
イベント状態の問合せに、1つのSELECT文ではできない複雑な処理が必要な場合は、まず特別の処理ステップが含まれるPL/SQLファンクションを作成し、次にそのPL/SQLファンクションをユーザー定義のSQLイベント・テストとともに使用します。作成したPL/SQLファンクションにより、さらに警告および警戒しきい値と比較できる値が返されます。
例:
従業員の給料が、
管理者の最も高い給料を500ドル上回ると、警告をトリガーする必要があるとします。まず、PL/SQLファンクションを次のように定義します。
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;
このPL/SQLファンクションでは、最も高い従業員の給料と最も高い管理者の給料の差を返します。この差が正数の場合は、従業員の給料の方が高くなります。差が500を上回る場合、警告をトリガーする必要があります。
ユーザー定義のSQLイベント・テストを使用してこのイベントを定義する場合、次のようにSQL文を定義します。
select overpaid_emp from dual
次に演算子">"を使用し、警戒のしきい値を100、警告のしきい値を500とします。
PL/SQLファンクションではROLESは使用できないため、ROLESで付与されている権限は、このファンクションからは機能しないことに注意してください。イベントに使用されるデータベース・ユーザー・アカウントに対して、直接権限を付与することが必要な場合もあります。(イベントに使用されるデータベース・ユーザー・アカウントは、データベースの優先情報リストのユーザーか、優先接続情報リストを上書きするように指定された接続情報のいずれかです。)
パラメータ
・ 優先接続情報リストを上書き: ユーザー名やパスワードまたはこの両方を変更するときにこのボックスをチェックします。
・ 演算子: 次の比較演算子のいずれかを選択します。次の比較演算子のいずれかを選択します。==(等しい)、<(より小さい)、>(より大きい)、<=(以下)、>=(以上)、!=(等しくない)
・ 警告のしきい値: SQLスクリプトに応じて、数値やテキスト文字列を入力します。
・ 警戒のしきい値: SQLスクリプトに応じて、数値やテキスト文字列を入力します。
・ 通知前の発生: テストで真が返される所要回数を示す数値を入力します。この数値に達するとコンソールへの警告フラグの表示および通知の送信が発生します。
・ SQL: 使用するSQLスクリプトを入力します。既存のスクリプトからSQLを切り取り、貼り付けることもできます。
出力
SQLスクリプトで返される値
デフォルト頻度
60秒
ユーザーの操作
アクションは個々のSQLスクリプトによって異なるため、Oracleでは、推奨事項が提示できません。