opencodez

Oracle Job Scheduler Guide With Examples – Part 1

Oracle Database provides scheduling capabilities with an inbuilt Oracle Job Scheduler. Oracle has the DBMS_SCHEDULER (dbms scheduler) package which provides a collection of scheduling functions and procedures that are callable from any PL/SQL program. We can even use SQL Developer IDE to create and schedule jobs.

In this 3 part article, we will see everything about jobs scheduling in Oracle. We will see examples and illustration code to understand things better.

Tools Used:

In the first part of the article, we will briefly visit the components used for scheduler jobs and what are the prerequisites that need to be done before any of the component is created.

Job

A job is the combination of a schedule and a program, along with any additional arguments required by the program. A schedule is nothing but the frequency of job execution. A job can perform a task that is defined by one of these x

Program

A program is a collection of metadata about a particular task. The programs are not schedulable on their own. You need to define program using one of x

Chain

A chain is a series of programs that are linked together to perform a particular group of activities. To create a chain, you need to follow below steps x

Prerequisites

To create a database jobs, program, and chains we need to grant our users some privileges. To do that connect to the database using SQL plus command line and execute below code blocks. You need to connect as SYSDBA

BEGIN
GRANT CREATE ANY JOB TO xUSER NAMEx;
GRANT EXECUTE ON DBMS_SCHEDULER TO xUSER NAMEx;
GRANT MANAGE SCHEDULER TO xUSER NAMEx;
END;

BEGIN
DBMS_RULE_ADM.GRANT_SYSTEM_PRIVILEGE(DBMS_RULE_ADM.CREATE_RULE_OBJ, 'xUSER NAMEx');
DBMS_RULE_ADM.GRANT_SYSTEM_PRIVILEGE(DBMS_RULE_ADM.CREATE_RULE_SET_OBJ, 'xUSER NAMEx');
DBMS_RULE_ADM.GRANT_SYSTEM_PRIVILEGE(DBMS_RULE_ADM.CREATE_EVALUATION_CONTEXT_OBJ, 'xUSER NAMEx');
END;
/

Illustration

For illustrations purpose, we have defined 2 tables and 3 procedures. Brief description of them is as

The code for the above illustrations can be downloaded from our GIT Repository

So far we have covered the basics of Oracle job scheduling now letxs see it in action. In this part, we will go through an example of creating a job using a stored procedure.

Oracle Job Scheduler x Create a Job with Stored Procedure

As mentioned earlier, we will create a job stored procedure. We are using SQL Developer to create our Job. Depending upon the type of job you choose to create it will prompt you to define the parameters. E.g. if you choose to create PL/SQL block it will give you space to write your code. If you choose the stored procedure, then it will list down all the procedures available for that user and you can select any one of that to be scheduled as a job.

Letxs see each of the steps for the same

  1. In the SQL developer right click on Job and select New Job (Wizard)
  2. You will see the below screen. Specify the name and description.
  3. Keep Job class as default.
  4. Select the “Repeating” from when to execute the job
  5. Click on the pencil icon, it will open up another window where you can specify when this job will be executed. Set the frequency as desired and click ok.
  6. You can see above how the interval is set for this job to be executed every 15 minutes.
  7. Click on Next. Keep default setting for step 2 and 3
  8. On step 4 change the priority and set it to 1 as shown below. Keep the rest of the settings as default.
  9. Click on Finish.

The Job is scheduled and it will be executed every 15 mins. For output purposes, I have set the job to run every 2 minutes. Below are the entries form JOB_LOG table.

If you don’t want to use SQL developer, you can also use below PL/SQL to create a job and schedule it.

BEGIN
    DBMS_SCHEDULER.CREATE_JOB (
            job_name =x '"PAVANS"."ORACLE_JOB_PROC"',
            job_type =x 'STORED_PROCEDURE',
            job_action =x 'PAVANS.PKG_TEST_SCHEDULER.JOB_PROC_STEP_1',
            number_of_arguments =x 0,
            start_date =x NULL,
            repeat_interval =x 'FREQ=MINUTELY;INTERVAL=15',
            end_date =x NULL,
            enabled =x FALSE,
            auto_drop =x FALSE,
            comments =x 'Oracle Job');

    DBMS_SCHEDULER.SET_ATTRIBUTE( 
             name =x '"PAVANS"."ORACLE_JOB_PROC"', 
             attribute =x 'job_priority', value =x '1');
    DBMS_SCHEDULER.SET_ATTRIBUTE( 
             name =x '"PAVANS"."ORACLE_JOB_PROC"', 
             attribute =x 'logging_level', value =x DBMS_SCHEDULER.LOGGING_OFF);
    
    DBMS_SCHEDULER.enable(
             name =x '"PAVANS"."ORACLE_JOB_PROC"');
END;

Thatxs it for this article. We will see how we can create programs and chains in our upcoming posts. Stay tuned.

Guide Index

  1. Oracle Job Scheduler Guide With Examples x Part I
  2. Oracle Job Scheduler Guide With Examples x Part II
  3. Oracle Job Scheduler Guide With Examples x Part III

You can refer the Oracle package and table script from out Git Repository.

Download from Git

You may also be interested in our basic SQL Tutorials from scratch : 

SQL For QA : Tutorial#1 x Select Query

x

x