スケジューラジョブの作成、手動実行、無効化、削除

コマンド

-- 1) Create disabled, set attributes, then enable:
BEGIN
  DBMS_SCHEDULER.CREATE_JOB(
    job_name        => 'CUSTOMER_APP.NIGHTLY_STATS',
    job_type        => 'PLSQL_BLOCK',
    job_action      => q'[BEGIN DBMS_STATS.GATHER_SCHEMA_STATS(ownname => 'CUSTOMER_APP', options => 'GATHER STALE'); END;]',
    start_date      => SYSTIMESTAMP,
    repeat_interval => 'FREQ=DAILY; BYHOUR=2; BYMINUTE=30; BYSECOND=0',
    enabled         => FALSE,
    auto_drop       => FALSE,
    comments        => 'Nightly stale statistics gathering');
  DBMS_SCHEDULER.SET_ATTRIBUTE('CUSTOMER_APP.NIGHTLY_STATS', 'max_run_duration', INTERVAL '2' HOUR);
  DBMS_SCHEDULER.SET_ATTRIBUTE('CUSTOMER_APP.NIGHTLY_STATS', 'logging_level', DBMS_SCHEDULER.LOGGING_FULL);
  DBMS_SCHEDULER.ENABLE('CUSTOMER_APP.NIGHTLY_STATS');
END;
/

-- 2) Validate the calendar expression (next run time):
SET SERVEROUTPUT ON
DECLARE
  l_next TIMESTAMP WITH TIME ZONE;
BEGIN
  DBMS_SCHEDULER.EVALUATE_CALENDAR_STRING(
    calendar_string   => 'FREQ=DAILY; BYHOUR=2; BYMINUTE=30; BYSECOND=0',
    start_date        => SYSTIMESTAMP,
    return_date_after => SYSTIMESTAMP,
    next_run_date     => l_next);
  DBMS_OUTPUT.PUT_LINE('Next run: ' || l_next);
END;
/

-- 3) Run now in the background (does not affect the schedule):
EXEC DBMS_SCHEDULER.RUN_JOB('CUSTOMER_APP.NIGHTLY_STATS', use_current_session => FALSE);

-- 4) Status:
SELECT owner, job_name, enabled, state, run_count, failure_count,
       last_start_date, next_run_date
FROM   dba_scheduler_jobs WHERE owner = 'CUSTOMER_APP';

-- 5) Stop (if running) / disable / drop:
-- EXEC DBMS_SCHEDULER.STOP_JOB('CUSTOMER_APP.NIGHTLY_STATS', force => FALSE);
EXEC DBMS_SCHEDULER.DISABLE('CUSTOMER_APP.NIGHTLY_STATS', force => TRUE);
EXEC DBMS_SCHEDULER.DROP_JOB('CUSTOMER_APP.NIGHTLY_STATS', force => TRUE);

概要

DBMS_SCHEDULERでスケジュール済みのPL/SQLジョブを定義する。max_run_duration(超過時にイベントを発生)と詳細なロギングレベルを設定し、カレンダ式を事前に検証し、スケジュールを乱さずに手動実行できる。

使用する場面

メンテナンス、ETL、クリーンアップなどの定期的なデータベース作業を、cronではなくデータベース内でRAC/Data Guardを考慮して実行するために。

注意

追加ライセンス不要。start_dateのタイムゾーンが重要: SYSTIMESTAMPはデータベースサーバーのTZを使用する。夏時間の切り替え時のずれを避けるため、明示的なリージョン(例: 'Europe/Istanbul')を使用する。JOB_QUEUE_PROCESSES=0の場合、ジョブは実行されない。force=>TRUEでのDISABLEは実行中のインスタンスを停止せず、今後の実行を防ぐのみ。中断するにはSTOP_JOBを使用する。別のスキーマにジョブを作成するにはCREATE ANY JOBが必要。