全面学习ORACLE Scheduler特性(3)使用Programs

二、使用Programs

　　在论坛中偶尔见过有人讨论如何在中执行操作系统命令，或是ORACLE数据库外的应用。应该说在9i及之前的版本中，虽然说并非完全无法实现（其实还是有多种方式能够变相实现的），不过复杂的实现方式让DBA使劲了力，伤透了心，费劲了事儿。

　　进入版本之后，就完全不必如此费神，因为有了DBMS_SCHEDULER，因为有了PROGRAM。

2.1  创建Programs

　　 中的Program对象并不是常规意义上的"程序"或"应用"，而就是一个"对象"，由DBA定义的，具有执行某项功能的特殊对象。Program中实际执行的操作可以分为下列三种类型：

• PL/SQL BLOCK ：标准的pl/sql代码块；
• STORED PROCEDURE ：编译好的PL/SQL存储过程，或者Java存储过程，以及外部的c子程序；
• EXECUTEABLE ：ORACLE数据库之外的应用，比如操作系统命令等等。

　　创建Programs使用DBMS_SCHEDULER.CREATE_PROGRAM过程，该过程支持的参数如下：

JSSWEB>  desc dbms_scheduler.create_program;

Parameter           Type           Mode Default? 

------------------- -------------- ---- -------- 

PROGRAM_NAME        VARCHAR2       IN            

PROGRAM_TYPE        VARCHAR2       IN            

PROGRAM_ACTION      VARCHAR2       IN            

NUMBER_OF_ARGUMENTS BINARY_INTEGER IN   Y        

ENABLED             BOOLEAN        IN   Y        

OMMENTS            VARCHAR2       IN   Y      

　　如上所示，前三项为必选参数，各参数实际代表的意义如下：

• PROGRAM_NAME ：指定一个program名称；
• PROGRAM_TYPE ：Program的类型，如前文中所述，Program支持三种类型；
• PROGRAM_ACTION ：实际执行的操作，应与前面PROGRAM_TYPE参数关联使用。比如说前面指定了PROGRAM_TYPE为"PLSQL_BLOCK"，那么此处要执行的action就应当是一段标准的pl/sql代码。如果前面指定PROGRAM_TYPE为"STORED_PROCEDURE"，那么此处要执行的action就应当是ORACLE中定义好的存储过程(含Java存储过程)，如果前面指定PROGRAM_TYPE为"EXECUTABLE"，那么此处就应该指定外部命令的命令行信息(含路径信息)；
• NUMBER_OF_ARGUMENTS ：指定支持的参数个数，默认值为0即没有参数。每个program最多能够支持255个参数，注意如果PROGRAM_TYPE设置为PLSQL_BLOCK，那么本参数自动忽略；
• ENABLED ：指定是否将创建的program置为有效状态，默认情况下为false。
• COMMENTS ：这个不用再说了吧，注释信息。

　　下面实际操作一下看看，PL/SQL或PROCEDURE没有挑战(ORACLE中直接即可调用)，咱们创建一下program，直接调用操作系统中的ls命令，操作如下：

SQL> BEGIN

  2  DBMS_SCHEDULER.CREATE_PROGRAM (

  3     program_name           => 'my_program1',

  4     program_action         => '/bin/date',

  5     program_type           => 'EXECUTABLE',

  6     enabled                => TRUE);

  7  END;

  8  /

PL/SQL procedure successfully completed.

2.2  管理Programs

　　定义的program如何执行，这里先卖个关子，前面介绍CREATE_PROGRAM过程的参数时提到，每个program最多支持255个参数，要为program添加参数，可以通过DEFINE_PROGRAM_ARGUMENT过程。不过在为其添加参数前，要注意program的NUMBER_OF_ARGUMENTS指定的数量，如果该值为0，那么为其添加参数时就会报错。

　　查询创建的program的信息，可以通过USER_SCHEDULER_PROGRAMS视图，例如：

SQL> select program_name,program_type,program_action,number_of_arguments,enabled

  2  from user_scheduler_programs;

PROGRAM_NAME         PROGRAM_TYPE     PROGRAM_ACTION       NUMBER_OF_ARGUMENTS ENABL

-------------------- ---------------- -------------------- ------------------- -----

MY_PROGRAM1          EXECUTABLE       /bin/ls                                1 FALSE

　　由于前面创建program時並未指定NUMBER_OF_ARGUMENTS的值，因此我们这里需要首先修改该值为一个非0值，操作如下：

SQL> exec dbms_scheduler.set_attribute('my_program1','NUMBER_OF_ARGUMENTS',1);

PL/SQL procedure successfully completed.

　　没错，操作还是使用DBMS_SCHEDULER.SET_ATTRIBUTE过程。另外需要注意，program的NUMBER_OF_ARGUMENTS参数可是说想改就能改的，正常情况下该处理必须是在program处于enabled之前确认完毕，否则会触发ORA-27465错误，因此要修改program的参数之前，必须首先确保要修改program的enabled状态为false。

　　那么对于已经处于enabled状态的program，如何修改其状态属性呢？其实很简单，前面操作jobs时使用的DBMS_SCHEDULER.DISABLE过程还记的吗？没错，该过程对于program同样好使，并且调用方式也完全一样，例如：

SQL> exec dbms_scheduler.disable('my_program1');

PL/SQL procedure successfully completed.

　　另外，如果希望将program置为enabled状态，执行DBMS_SCHEDULER.ENABLE过程即可，这里不再例举。

　　接下来，就可以为刚刚创建的my_program1添加路径参数，操作如下：

SQL> BEGIN

  2  DBMS_SCHEDULER.DEFINE_PROGRAM_ARGUMENT (

  3     program_name            => 'my_program1',

  4     argument_position       => 1,

  5     argument_name           => 'dirpath',

  6     argument_type           => 'VARCHAR2',

  7     default_value           => '/home/oracle');

  8  END;

  9  /

PL/SQL procedure successfully completed.

　　查询为program定义的参数，可以通过USER_SCHEDULER_PROGRAM_ARGS视图，例如：

SQL> select program_name,argument_name,argument_position,argument_type

  2  default_value from user_scheduler_program_args;

PROGRAM_NAME         ARGUMENT_NAME        ARGUMENT_POSITION DEFAULT_VALUE

-------------------- -------------------- ----------------- --------------------

MY_PROGRAM1          DIRPATH                              1 VARCHAR2

　　删除program的argument操作也很简单，使用DROP_PROGRAM_ARGUMENT过程即可，例如：

SQL> exec dbms_scheduler.drop_program_argument('my_program1','dirpath');

PL/SQL procedure successfully completed.

　　该过程第一个参数指定program名称，第二个参数指定定义的argument名称，当然此处也可以指定argument的位置，即前例视图返回结果中的 ARGUMENT_POSITION 列值。

　　要删除program的话就更简单了，使用DROP_PROGRAM过程即可，例如：

SQL> exec dbms_scheduler.drop_program('my_program1');

PL/SQL procedure successfully completed.

　　当然啦，删除program的同时，也会删除该program对应的所有arguments。

　　实际上SCHEDULER中创建job时，也可以指定执行外部的程序。SCHEDULER中的Job更像是之前版本继承过来的JOBS，只不过10g中SCHEDULER管理的JOBS功能更加强大。Programs与Jobs不同的是，Jobs是定义好的，定时执行的任务，而Programs则是定义好的，等待被执行的对象。那么Programs是由谁来执行呢，不要走开，广告之后即将全面揭晓。

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