用户定义的 SQL 事件测试使您能够自行定义评估事件测试的 SQL 脚本。您定义的事件测试应作为返回当前正在监视的条件值的查询来编写 (例如,SELECT 语句)。系统将根据所指定的预警阈值和警告阈值限制检查这些值,如果达到了阈值限制则触发事件。
示例:
假定现有一个对 Oracle 数据库运行的自定义应用程序。每次该应用程序查找到应用程序错误时,它将在名为
“error_log”的表中创建一个条目。使用“用户定义的 SQL 测试”,可以编写一个事件测试,以便在查找到至少 50 个错误时通知您。您应明确定义以下 SQL 语句:
select count(*) from error_log
该语句将返回 error_log 表中的行数。如果希望在至少达到 50 时得到一个预警,可指定运算符“ >= ”,预警值为 50,警告值可为 30。
对 PL/SQL 函数的支持
如果事件条件查询需要的处理比单一 SELECT 语句中所允许的处理更为复杂,您可以首先创建一个包含额外处理步骤的 pl/sql 函数,然后在用户定义的 SQL 事件测试中使用此 pl/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 无法提出任何建议。