zoukankan      html  css  js  c++  java
  • dbms_scheduler介绍

    dbms_scheduler介绍
    10g引入的这个dbms_scheduler包,替代了之前的dbms_job包,该包功能更强大,可以将job需要的各种资源分开再进行组合。

    1.program
    1.1 create_program
    参数说明:
      program_name——程序名称
      program_type——程序类型(STORED_PROCEDURE,PLSQL_BLOCK,EXECUTABLE)
          STORED_PROCEDURE——ORACLE 中定义好的存储过程
          PLSQL_BLOCK——是一段标准的pl/sql 代码
          EXECUTABLE——指定外部命令的命令行信息(含路径信息)
      program_action——具体对应的执行内容,若为过程则为过程名
      enable——若为true则创建后激活反之不激活
      comments——注释
    例子:
    BEGIN
       dbms_scheduler.create_program(program_name        => 'myprogram',
                                     program_type        => 'STORED_PROCEDURE',
                                     program_action      => 'p_test1',
                                     number_of_arguments => 1,
                                     enabled             => FALSE,
                                     comments            => '更新gi_pipe表');
       
    END;
    注:如果创建的程序需要输入参数,则必须定义完参数后在激活,即创建这个program时将enable设为false,否则提示:
        Ora-27456:程序“ ”的参数并未全部定义;然后再对该program定义参数即执行define_program_argument过程(见1.3)。

    --查看定义的program
    SELECT * FROM user_scheduler_programs;

    1.2 drop_program
    参数说明:
    program_name——要删除的程序名称
    force——true或者false。如果为true则不管该program是否被job引用都会删除,FALSE则若被引用无法删除,默认为false。
    例子:
    BEGIN
       dbms_scheduler.drop_program(program_name => 'myprogram',force => TRUE);
    END;

    1.3 define_program_argument
    参数说明:
    program_name——程序名称
    argument_position——参数位置(也可以知道参数名称选择argument_name)
    argument_type——参数类型
    default_value——参数默认值

    例子:
    BEGIN
       dbms_scheduler.define_program_argument(program_name      => 'myprogram',
                                              argument_position => 1,
                                              argument_name     => 'p_lttid',
                                              argument_type     => 'varchar2',
                                              default_value     => 'daaa');
    END;

    --查看定义的program参数    
    SELECT *FROM User_Scheduler_Program_Args;

    1.4 define_anydata_argument(用于定义输入参数为复杂类型需采用sys.AnyData类型来包装的参数)
    参数说明:
    program_name——程序名称
    argument_position——参数位置(也可以知道参数名称选择argument_name)
    argument_type——参数类型为sys.AnyData
    default_value——参数默认值


    1.5 define_metadata_argument
    有效的metadata attributes有: 'job_name', 'job_subname', 'job_owner', 'job_start', 'window_start',
                                 'window_end', and 'event_message'.
    Metadata Attribute              Data Type                              Description
    job_name                        VARCHAR2                               当前执行的job名称
    job_subname                     VARCHAR2                               当前执行的job子名称
    job_owner                       VARCHAR2                               当前执行的job所有者
    job_start                   TIMESTAMP WITH TIME ZONE                   job启动的时间
    window_start                TIMESTAMP WITH TIME ZONE                   window打开的时间
    window_end                  TIMESTAMP WITH TIME ZONE                   window关闭的时间
    event_message                                                          事件触发job启动的信息

    例子:(以下metadata_attribute设置为job_name,即以job_start这个值作为输入参数)
    BEGIN
       dbms_scheduler.define_metadata_argument(program_name       => 'myprogram',
                                               argument_position  => 1,
                                               argument_name      => 'p_lttid',
                                               metadata_attribute => 'job_start');
    END;
                                              

    1.6 drop_program_argument
    例子:
    BEGIN
       dbms_scheduler.drop_program_argument(program_name      => 'myprogram',
                                            argument_position => 1);
    END;

    2.schedule
    2.1 create_schedule
    参数说明:
    repeat_interval——运行频率
    end_date和comments默认可以不填
    例子:
    BEGIN
       dbms_scheduler.create_schedule(schedule_name   => 'myscheduler',
                                      repeat_interval => 'FREQ=MINUTELY;INTERVAL=2');
    END;


    2.2 create_event_schedule
    创建基于事件的调度,用于当一个特殊事件被抛出时启动一个job。
    Event类型     描述
    job_started   job启动
    job_succeeded job启动成功
    job_failed    job失败
    job_broken    被禁止或状态改为broken
    job_completed job执行完成即完成了限制的最大执行次数或者到达执行指定的结束时间
    job_stopped   停止job
    job_sch_lim_reached 达到了scheduler的限制设置的值
    job_disabled    禁止job
    job_chain_stalled  A job running a chain was put into the CHAIN_STALLED state. A running chain becomes
                       stalled if there are no steps running or scheduled to run and the chain evaluation_interval is set to NULL.
                       No progress will be made in the chain unless there is manual intervention.
    job_all_events Not an event, but a constant that provides an easy way for you to enable all events
    job_run_completed job执行或者失败或者成功或者被停止

    参数:
    event_condition——tab.user_data
    queue_spec——必须先创建一个queue,dbms_aqadm.create_queue

    --摘至http://www.233.com/oracle/zhonghe/20080807/104612630.html
    BEGIN
       dbms_scheduler.create_event_schedule(schedule_name       => 'acc_mgr_change',
                                            start_date        => systimestamp,
                                            event_condition => 'tab.user_data.event_name = ''acc_mgr_change''',
                                            queue_spec      => 'proc_queue');
    end;


    2.3 drop_schedule
    例子:
    BEGIN
      DBMS_SCHEDULER.drop_schedule(schedule_name => 'myscheduler');
    END;

    3.job
    3.1 create_job
    参数说明:
    job_type:类同上述创建program
    job_class DEFAULT 'DEFAULT_JOB_CLASS'
    enabled   默认FALSE,其创建后要想执行该job必须先执行enable过程
    auto_drop 默认TRUE,即当job执行完毕都到期是否直接删除job
    comments  默认NULL
    job_style 默认REGULAR
    credential_name 默认 NULL
    destination_name 默认 NULL

    --不采用program和scheduler直接创建job
    BEGIN
       dbms_scheduler.create_job(job_name        => 'myjob',
                                 job_type        => 'STORED_PROCEDURE',
                                 job_action      => 'p_test1',
                                 start_date      => '',
                                 repeat_interval => 'FREQ=DAILY;INTERVAL=2',
                                 enabled         => TRUE,
                                 comments        => 'My new job');
    END;

    --根据program和scheduler创建job
    BEGIN
       dbms_scheduler.create_job(job_name      => 'myjob',
                                 program_name  => 'myprogram',
                                 schedule_name => 'myscheduler');
    END;

    3.2 run_job
    BEGIN
       dbms_scheduler.run_job(job_name => 'myjob2');
    END;


    3.3 stop_job
    BEGIN dbms_scheduler.stop_job(job_name => 'myjob');END;

    3.4 copy_job
    BEGIN dbms_scheduler.copy_job(old_job =>'myjob' ,new_job =>'myjob2' );END;

    3.5 drop_job
    BEGIN dbms_scheduler.drop_job(job_name => 'myjob');END;

    3.6 set_job_argument_value
    设置job的输入参数值,设置后会覆盖原先定义该参数设置的默认值
    BEGIN
       dbms_scheduler.set_job_argument_value(job_name          => 'myjob2',
                                             argument_position => 1,
                                             argument_value    => 'qwerer');
    END;

    3.7 set_job_anydata_value
    方法类似3.6,只是设置的参数值类似是sys.anydata

    3.8 reset_job_argument_value
    重置job参数值,将其置为空

    4.group(11g才有的)
    4.1 create_group
    参数:
    group_type——组类型,该组的所有成员必须是同一类型,已有的类型有三种:
                DB_DEST:即成员为目标数据库,执行远程数据库的job;
                EXTERNAL_DEST(External destination):Members are external destinations, for running remote external jobs;
                WINDOW:Members are Scheduler windows
    创建时可以指定成员也可不指定,添加成员通过add_group_member过程添加。
    BEGIN
       dbms_scheduler.create_group(group_name =>,
                                   group_type =>,
                                   MEMBER     =>,
                                   comments   =>);
    END;

    4.2 drop_group
    删除组

    4.3 add_group_member
    为组添加成员

    4.4 remove_group_member
    移除组成员

    4.5 create_database_destination
    创建目标数据库,用于执行远程job
    AGENT——The external destination name of the Scheduler agent to connect. Equivalent to an agent name.
           The external destination must already exist. The external destination representing an agent is
           created automatically on a database instance when the agent registers with that instance.
           An agent‘s name is specified in its agent configuration file. If it is not specified, it defaults
           to the first part (before the first period) of the name of the host it resides on.

    DBMS_SCHEDULER.CREATE_DATABASE_DESTINATION (
       destination_name        IN VARCHAR2,--目标数据库名称
       agent                   IN VARCHAR2,--代理名称,事先创建好的
       tns_name                IN VARCHAR2,--tns名称
       comments                IN VARCHAR2 DEFAULT NULL);


    4.6 drop_database_destination
    4.7 drop_agent_destination

    5.jobclass
        Job Classes 相当于创建了一个job组,DBA可以将那些具有相同特性的job,放到相同的Job Classes中,
    然后通过对Job Class应用ORACLE中的"资源使用计划"特性,就可以对这些job执行过程中所需要的资源分配情况进行
    管理。
    5.1 create_job_class
    参数:
    resource_consumer_group——指定该jobclass所使用的资源分配方式。具体创建方法见dbms_resource_manager.create_consumer_group。
                             jobclass与resource_consumer_group为多对1关系;
                             若为该jobclass指定的resource_consumer_group被删除,则使用默认的resource_consumer_group;
                             若没为jobclass指定具体的resource_consumer_group,则使用默认的resource_consumer_group;
                             若为该jobclass指定的resource_consumer_group不存在,则会提示错误;
                             若为该jobclass指定了resource_consumer_group,则service参数必须设置为空(即这两个参数只能设置其中一个)。

    service——一般用于rac环境指定jobclass运行于哪个节点。

    logging_level——日志记录级别(DBMS_SCHEDULER.LOGGING_OFF,DBMS_SCHEDULER.LOGGING_RUNS,DBMS_SCHEDULER.LOGGING_FULL)
    log_history——日志存放时间,默认30
    例子:
    BEGIN
       dbms_scheduler.create_job_class(job_class_name          =>,
                                       resource_consumer_group =>,
                                       service                 =>,
                                       logging_level           =>,
                                       log_history             =>,
                                       comments                =>);
    END;


    5.2 drop_job_class
    --删除多个job class用逗号隔开
    BEGIN
       dbms_scheduler.drop_job_class(job_class_name => '');
    END;

    6.window
       通常job启动后,用户只能被动地等待其执行,一直到其执行地任务完成(或DBA手动kill对应进程),在此期间,
    执行的job将与其它活动的进程共同竞争当前系统中的资源。在9i之前就是这样。在Job Classes中也可以控制job能够
    使用的资源,不过单单使用Job Classes并不能灵活的控制job在合适的时间使用适当的资源。进入10g之后,采用
    dbms_scheduler的WINDOW可以缓解该问题。WINDOW 可以指定一个时间窗口,在此期间,通过与Job Classes的搭配组合,
    能够有效控制job执行时支配(使用)的资源。比如说job通常是在凌晨服务器负载较低时执行,那么就可以通过WINDOW
    设置在此期间,允许jobs使用更多的系统资源,而到了工作时间后,如果job仍未执行完成,为其分配另一个有限的
    资源,以尽可能降低job执行占用的资源对其它业务的影响。

    6.1 create_window
    参数:
    resource_plan——资源计划,即通过 dbms_resource_manager.create_plan来创建。
    schedule_name——调度名称,基于已经创建好的调度创建window。
    duration——时间窗口打开后持续的时间,创建时必须设置该值,因为没有默认值,设置范围从1分钟到99天。
    window_priority——window优先级,如果同一时间出现多个window时则根据优先级决定执行哪个。
    --创建一个基于调度的window
    BEGIN
       dbms_scheduler.create_window(window_name     =>,
                                    resource_plan   =>,
                                    schedule_name   =>,
                                    duration        =>,
                                    window_priority =>,
                                    comments        =>);
    END;

    --不基于时间调度创建window
    DBMS_SCHEDULER.CREATE_WINDOW (
       window_name             IN VARCHAR2,
       resource_plan           IN VARCHAR2,
       start_date              IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
       repeat_interval         IN VARCHAR2,
       end_date                IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
       duration                IN INTERVAL DAY TO SECOND,
       window_priority         IN VARCHAR2                 DEFAULT 'LOW',
       comments                IN VARCHAR2                 DEFAULT NULL);

    6.2 drop_window
    删除一个window。

    6.3 open_window
    打开一个window。

    6.4 close_window
    关闭一个window。


    7.windowgroup
        一个WINDOW GROUP可能包含多个WINDOW。使用WINDOW GROUP的本意是这样的,假如说某个job执行的时间比较长,
    甚至全天24小时都在执行,对于这类job,单个WINDOW很难有效调整其资源占用,因此就可以通过设置一个
    WINDOW GROUP,该WINDOW GROUP中包含了多个WINDOW,每个WINDOW分别负责不同时间点时的资源使用计划。然后在
    创建JOB时,指定schedule_name参数为WINDOW GROUP的名称,当然也可以直接指定window名称
    (window已经包含了调度信息了)。

    7.1 create_window_group
    BEGIN
       dbms_scheduler.create_window_group(group_name  =>,
                                          window_list =>,
                                          comments    =>);
    END;

    7.2 add_window_group_member
    增加一个window
    BEGIN
       dbms_scheduler.add_window_group_member(group_name => ,window_list => );
    END;

    7.3 remove_window_group_member
    移除一个window

    7.4 drop_window_group
    删除一个window


    8.chain 参考http://hi.baidu.com/sqlnever/item/be05b1abba1611fc15329b86
        CHAIN可以被视做多个program放到同一个链中,这样的话就可以指定这些program执行的先后顺序。
    8.1 create_chain
    DBMS_SCHEDULER.CREATE_CHAIN (
       chain_name              IN VARCHAR2,
       rule_set_name           IN VARCHAR2 DEFAULT NULL,
       evaluation_interval     IN INTERVAL DAY TO SECOND DEFAULT NULL,
       comments                IN VARCHAR2 DEFAULT NULL);


    8.2 define_chain_rule
    定义规则
    举例,如my_step1执行完则执行my_step2,若my_step2执行完则结束
    BEGIN
       dbms_scheduler.define_chain_rule(chain_name => 'my_chain1',
                                        condition  => 'TRUE',
                                        action     => 'start my_step1',
                                        rule_name  => 'my_rule1');
       dbms_scheduler.define_chain_rule(chain_name => 'my_chain1',
                                        condition  => 'my_step1 completed',
                                        action     => 'start my_step2',
                                        rule_name  => 'my_rule2');
       dbms_scheduler.define_chain_rule(chain_name => 'my_chain1',
                                        condition  => 'my_step2 completed',
                                        action     => 'end 0',
                                        rule_name  => 'my_rule3');
    END;

    8.3 define_chain_step
     BEGIN
        dbms_scheduler.define_chain_step(chain_name   => 'my_chain1',
                                         step_name    => 'my_step1',
                                         program_name => 'p_p2');
        dbms_scheduler.define_chain_step(chain_name   => 'my_chain1',
                                         step_name    => 'my_step2',
                                         program_name => 'p_p3');
     END;

    8.4 define_chain_event_step
    BEGIN
       dbms_scheduler.define_chain_event_step(chain_name          =>,
                                              step_name           =>,
                                              event_schedule_name =>,
                                              timeout             =>);
    END;

    8.5 drop_chain_rule
    dbms_scheduler.drop_chain_rule(chain_name => ,rule_name => );

    8.6 drop_chain_step
    dbms_scheduler.drop_chain_step(chain_name => ,step_name => );

    8.7 alter_chain
    dbms_scheduler.alter_chain(chain_name => ,step_name => ,attribute => ,value => );

    8.8 drop_chain

    8.9 analyze_chain
    dbms_scheduler.analyze_chain(chain_name => ,rules => ,steps => ,step_pairs => );

    8.10 alter_running_chain
    dbms_scheduler.alter_running_chain(job_name => ,step_name => ,attribute => ,value => );

    8.11 evaluate_running_chain
    dbms_scheduler.evaluate_running_chain(job_name => );

    8.12 run_chain
    dbms_scheduler.run_chain(chain_name => ,start_steps => ,job_name => );


    9.credential
    创建用户名密码,用于认证job执行
    9.1 create_credential
    BEGIN
       dbms_scheduler.create_credential(credential_name =>,
                                        username        =>,
                                        password        =>,
                                        database_role   =>,
                                        windows_domain  =>,
                                        comments        =>);
    END;

    9.2 drop_credential
    9.3 put_file
    BEGIN
       dbms_scheduler.put_file(destination_file        =>,
                               destination_host        =>,
                               credential_name         =>,
                               file_contents           =>,
                               destination_permissions =>);
    END;

    9.4 get_file
    9.5 create_file_watcher
    BEGIN
       dbms_scheduler.create_file_watcher(file_watcher_name     =>,
                                          directory_path        =>,
                                          file_name             =>,
                                          credential_name       =>,
                                          destination           =>,
                                          min_file_size         =>,
                                          steady_state_duration =>,
                                          comments              =>,
                                          enabled               =>);
    END;

    9.6 drop_file_watcher
    9.7 add_job_email_notification
    BEGIN
       dbms_scheduler.add_job_email_notification(job_name         =>,
                                                 recipients       =>,
                                                 sender           =>,
                                                 subject          =>,
                                                 BODY             =>,
                                                 events           =>,
                                                 filter_condition =>);
    END;

    9.8 remove_job_email_notification

    10.通用的
    10.1 DISABLE
    BEGIN
       dbms_scheduler.disable(NAME => 'myjob2');
    END;

    10.2 enable
    BEGIN
       dbms_scheduler.enable(NAME => 'myprogram');
    END;

    BEGIN
       dbms_scheduler.enable(NAME => 'myjob2');
    END;

    10.3 set_attribute
    attribute:是指设置job的属性,属性有:
    logging_level——记录的日志信息,有三个值(DBMS_SCHEDULER.LOGGING_OFF,DBMS_SCHEDULER.LOGGING_RUNS,
                                             DBMS_SCHEDULER.LOGGING_FULL)
    restartable——设置job失败是否要重启
    max_failures——允许job失败的次数,范围1到1000000,默认为空。
    max_runs——job执行的最大次数,范围1到1000000,默认为空(即意味着job会重复执行,或者到达job执行的end_date,或者达到指定失败的次数)。
              一旦达到设置的最大值,job将会disable并且状态变更为COMPLETED
    max_run_duration——设置job运行的有效时间,如果设置了某个值,则在到达该值时调度会报JOB_OVER_MAX_DUR事件,
                      然后由事件处理器决定是否要继续
    instance_stickiness——只用于rac数据库。默认为true,设置为true,则job会运行在负载最轻的节点上;如果某节点
                         关闭或负载太重,则不会启动新job,而是有另一个节点来执行该job。
    stop_on_window_close——window关闭的时候停止job,默认为false。因此默认情况下关闭了window,job还是会继续执行,
                          但是要注意,window关闭则意味着资源使用计划就会变化。
    job_priority——在同一个class,job执行的优先级,默认为3.
    schedule_limit——允许启动job延迟的时间,设置值从1分钟到99天。超过了延迟的时间则不再启动job。如果不设置
                    该值,则只要得到允许所需的资源就会启动。另外,在延迟的这段时间里,job的执行次数或失败次数
                    会跳过,不计算这段时间的。
    program_name——job执行的对象。如果设置了该属性,则job_action, job_type,number_of_arguments要设置为空。
    job_action——job执行对象内容
    job_type——job执行对象类型('PLSQL_BLOCK', 'STORED_PROCEDURE', 'EXECUTABLE', and 'CHAIN')。如果设置了该值,
              那么program_name参数必须设置为空 。
    number_of_arguments——参数个数。如果设置了该值,那么program_name参数必须设置为空。
    schedule_name——调度名,如果设置了该值,则end_date, start_date and repeat_interval需设置为空。
    repeat_interval——执行间隔,设置了该值,则schedule_name需为空。
    start_date——执行开始时间,设置了该值,则schedule_name需为空。
    end_date——不再执行job的时间,设置了该值,则schedule_name需为空。
    job_class——jobclass
    comments——备注
    auto_drop——当job状态为completed则自动删除该job
    event_spec——需含两个值(event condition和queue specification)
    raise_events——设置当job为什么状态时抛出,具体的时间类型见event类型。
     
    --设置log_history为90天,默认30天
    BEGIN
       dbms_scheduler.set_scheduler_attribute('log_history', '90');
    END;

    10.4 set_attribute_null
    10.5 get_attribute


    11.schedulerattribute
    设置调度属性的值
    11.1 set_scheduler_attribute
    attribute类型有:default_timezone,email_server,email_sender,email_server_credential,email_server_encryption,
                    event_expiry_time ,log_history,max_job_slave_processes(没使用)

    BEGIN
       dbms_scheduler.set_scheduler_attribute(attribute => ,value => );
    END;


    11.2 get_scheduler_attribute
    BEGIN
       dbms_scheduler.get_scheduler_attribute(attribute => ,value => );
    END;

    11.3 add_event_queue_subscriber
    BEGIN
       dbms_scheduler.add_event_queue_subscriber(subscriber_name => );
    END;

    11.4 remove_event_queue_subscriber
    BEGIN
       dbms_scheduler.remove_event_queue_subscriber(subscriber_name => );
    END;
    11.5 purge_log
    BEGIN
       dbms_scheduler.purge_log(log_history => ,which_log => ,job_name => );
    END;


    dbms_scheduler包一些视图
    --*代表all或dba或user
    --1.查看job的视图
    *_scheduler_jobs --查看job
    *_scheduler_job_args  --查看job的所有输入参数
    *_scheduler_job_classes --查看job的类信息
    *_scheduler_job_dests --查看job状态
    *_scheduler_job_log --查看job日志
    *_scheduler_job_run_details --查看job执行的详细信息
    all_scheduler_running_jobs

    --2.查看chain的一些视图
    *_scheduler_chains
    *_scheduler_chain_rules
    *_scheduler_chain_steps
    *_scheduler_running_chains --查看正在执行的chains

    --3.查看program的视图
    *_scheduler_programs --查看程序
    *_scheduler_program_args --查看程序参数

    --4.查看调度组信息
    *_scheduler_groups
    *_scheduler_group_members

    --5.查看window的视图(这类视图只有dba和all开头的)
    *_scheduler_windows --查看window
    *_scheduler_window_details --查看window详细信息
    *_scheduler_window_groups --查看window组
    *_scheduler_window_log --查看window日志
    *_scheduler_wingroup_members ----查看window成员

    --6.查看scheduler视图
    *_scheduler_schedules --查看调度
    *_scheduler_global_attribute --显示所有的调度属性
    *_scheduler_credentials
    *_scheduler_db_dests
    *_scheduler_dests
    *_scheduler_external_dests
    *_scheduler_file_watchers
    *_scheduler_notifications
    *_scheduler_remote_databases
    *_scheduler_remote_jobstate

  • 相关阅读:
    remove '^M' in shell script
    MyBatis学习总结——实现关联表查询(转)
    SSM框架下结合 log4j、slf4j打印日志
    intellij IDEA里各图标对应的文件类型
    springboot整合shiro
    在Eclipse中如何关联源代码
    windows7 创建http 服务器
    Intellij IDEA 安装和配置jrebel进行项目的热部署
    IntelliJ IDEA 热部署插件 JRebel 安装激活及使用
    idea 安装热部署插件
  • 原文地址:https://www.cnblogs.com/lanzi/p/2784815.html
Copyright © 2011-2022 走看看