Oracle Scheduler特性(7)Scheduler抛出的Events

四、使用Events

Event直译对应的中文解释是指事件，不过单纯讲事件毕竟太抽象了，举个示例来形容吧。A(对应某个应用程序，或者是Oracle中的进程)在干活时突然眉头一皱说道，不好，前方有情况，这可怎么办!这时，只见它认真想了想，过了一会儿脸上一喜说道：有了，俗话说早请示啊晚汇报，出现情况要找领导，赶紧给领导发消息呗!于是B(也是对应某个应用或oracle进程)就收到了一条A发过来的"前方有XX情况"的消息，这个过程就叫EVENT(含A发消息以及B接收消息)。

SCHEDULER 中有两种触发EVENT的情况：

Scheduler 触发的Events

Scheduler 中触发的Events，一般是说当前schduler中job的状态发生修改，类似job启动，或者运行结束，或者达到运行时间等诸如此类的动作，都能够抛出一个EVENT，接收到EVENT的applicate就可以根据这些信息进行适当的处理。

比如说，由于系统太过于繁忙，超出job启动时间后30分钟，job仍然没能顺利启动，那么这个时候，Scheduler就可以抛出一条EVENT给外部的应用，以便外部应用能够及时通知DBA，进行处理。

application 触发的Events

外部的应用也可以触发Events，并且由Scheduler来接收并处理这一类型的Events。所谓Scheduler处理EVENT就是指Scheduler启动相应的job来执行相关操作，这类job在创建时专门声明了event的处理，这样当接收到EVENT时，这类job就会启动。

Scheduler 使用Oracle高级队列来抛出以及销毁Events。当抛出Schduler触发的Events时，Scheduler将消息入队到默认的event队列，application则通过检查该队列来处理Events。当抛出application触发的Events时，application将消息入队到处理job对应的队列中。

下面我们也按照这两个类型来介绍Scheduler中的Events。

4.1 Scheduler抛出的Events

前面说了，Scheduler抛出的Events一般是指job状态改变时触发的，那么是不是说只要job状态发生了改变，就会触发Events，其实并非如此，因为默认情况下，job是不触发Events的。

Scheduler 中的job有一个属性叫raise_events，专门用来设置job触发Events的条件，该属性在CREATE_JOB时不能执行，因此默认情况下该属性不会赋值，自然也就不会触发EVENT。要设置raise_events属性，只能是在job创建完成后，通过SET_ATTRIBUTE过程修改job的raise_events属性。

例如，修改前面创建的job-，启用raise_events属性，执行语句如下：

SQL> BEGIN

2 DBMS_SCHEDULER.SET_ATTRIBUTE('INSERT_TEST_TBL', 'raise_events', DBMS_SCHEDULER.JOB_ALL_EVENTS)

3 END;

4 /

PL/SQL procedure successfully completed.

上述示例中指定的raise_events属性的属性值DBMS_SCHEDULER.JOB_ALL_EVENTS，就是抛出Events的触发条件。

触发Events的有下列的类型，分别代表不同的操作：

job_started ：JOB启动;

job_succeeded ：JOB成功结束;

job_failed ：JOB执行失败;

job_broken ：JOB被置为BROKEN状态;

job_completed ：JOB达到最大运行次数，或者运行的结束日期;

job_stopped ：JOB被STOP_JOB过程置为停止执行的状态;

job_sch_lim_reached ：Job的schedule达到限定值;

job_disabled ：JOB被置于DISABLE状态;

job_chain_stalled ：运行于chain的JOB被置于CHAIN_STALLED状态;

job_all_events ：含上述提到的所有类型;

job_run_completed ：由于Job运行出错、成功结束或被手动停止。

起用raise_events后，Scheduler就会按照设定的触发条件，当达到触发条件时，即会抛出事件信息到SYS.SCHEDULER$_EVENT_QUEUE队列。

例如，手动执行一次INSERT_TEST_TBL，看看是否向队列中记录信息，操作如下：

SQL> exec dbms_scheduler.run_job('INSERT_TEST_TBL');

PL/SQL procedure successfully completed.

执行下列脚本，出队数据：

SQL> set serveroutput on

SQL> DECLARE

2 l_dequeue_options DBMS_AQ.dequeue_options_t;

3 l_message_properties DBMS_AQ.message_properties_t;

4 l_message_handle RAW(16);

5 l_queue_msg sys.scheduler$_event_info;

6 BEGIN

7 l_dequeue_options.consumer_name := 'TEST';

8

9 DBMS_AQ.dequeue(queue_name => 'SYS.SCHEDULER$_EVENT_QUEUE',

10 dequeue_options => l_dequeue_options,

11 message_properties => l_message_properties,

12 payload => l_queue_msg,

13 msgid => l_message_handle);

14 COMMIT;

15

16 DBMS_OUTPUT.put_line('event_type : ' || l_queue_msg.event_type);

17 DBMS_OUTPUT.put_line('object_owner : ' || l_queue_msg.object_owner);

18 DBMS_OUTPUT.put_line('object_name : ' || l_queue_msg.object_name);

19 DBMS_OUTPUT.put_line('event_timestamp: ' || l_queue_msg.event_timestamp);

20 DBMS_OUTPUT.put_line('error_code : ' || l_queue_msg.error_code);

21 DBMS_OUTPUT.put_line('event_status : ' || l_queue_msg.event_status);

22 DBMS_OUTPUT.put_line('log_id : ' || l_queue_msg.log_id);

23 DBMS_OUTPUT.put_line('run_count : ' || l_queue_msg.run_count);

24 DBMS_OUTPUT.put_line('failure_count : ' || l_queue_msg.failure_count);

25 DBMS_OUTPUT.put_line('retry_count : ' || l_queue_msg.retry_count);

26 END;

27 /

event_type : JOB_STARTED

object_owner : TEST

object_name : INSERT_TEST_TBL

event_timestamp: 25-AUG-09 12.49.29.558758 PM +08:00

error_code : 0

event_status : 1

log_id :

run_count : 1

failure_count : 0

retry_count : 0

PL/SQL procedure successfully completed.

从返回的信息可以看到，event的类型为JOB_STARTED，表示JOB启动。实际上job:INSERT_TEST_TBL执行一次至少会向队列中插入两条event信息，一条为JOB_STARTED，一条则为JOB_SUCCEEDED(也可能是JOB_FAILED)，这里不详细演示，感兴趣的朋友不妨自行测试。

提示：SYS.SCHEDULER$_EVENT_QUEUE队列基于SYS.SCHEDULER$_EVENT_QTAB队列表，因此查询SYS.SCHEDULER$_EVENT_QTAB也可以获取上述的信息。

SYS.SCHEDULER$_EVENT_QUEUE 是一个固定队列，实际应用的过程中，DBA应该根据实际情况，将该表访问权限授予相关用户，以便顺利出队该队列中的events信息。

另外，友情提醒，默认情况下Scheduler仅保留最近24小时的Events信息，如果希望修改该设置的话，可以通过SET_SCHEDULER_ATTRIBUTE过程，修改scheduler的event_expiry_time属性，该项属性的属性值以秒为单位。

==============================================