Oracle JOB 排程間隔參數完整對照表：從每秒到每年、DBMS_SCHEDULER 現代化遷移

舊版 DBMS_JOB 以字串表達式定義間隔，易寫錯且無法精確控制。本文提供 **完整間隔參數對照表**，並推薦遷移至 10g+ **DBMS_SCHEDULER** 以獲得曆法語意、錯誤處理、日誌查詢等企業級功能。

DBMS_JOB 間隔字串對照表 (舊版相容)

DBMS_JOB 完整建立範例

CREATE OR REPLACE PROCEDURE proc_job_rain_jm IS
  l_jobno NUMBER;
BEGIN
  DBMS_JOB.SUBMIT(
    job       => l_jobno,
    what      => 'PROC_RAIN_JM;',  -- 呼叫的存儲過程
    next_date => SYSDATE,
    interval  => 'TRUNC(SYSDATE + 1)'  -- 每天午夜
  );
  COMMIT;
  DBMS_OUTPUT.PUT_LINE('Job No: ' || l_jobno);
END;
/

遷移至 DBMS_SCHEDULER (10g+ 強烈建議)

BEGIN
  DBMS_SCHEDULER.CREATE_JOB (
    job_name        => 'RAIN_JM_DAILY',
    job_type        => 'STORED_PROCEDURE',
    job_action      => 'PROC_RAIN_JM',
    start_date      => SYSTIMESTAMP AT TIME ZONE 'Asia/Taipei',
    repeat_interval => 'FREQ=DAILY; BYHOUR=0; BYMINUTE=0; BYSECOND=0',  -- 曆法語意
    end_date        => NULL,
    enabled         => TRUE,
    auto_drop       => FALSE,
    comments        => '每日午夜同步雨量資料'
  );
END;
/

SCHEDULER 曆法語意優勢

• 可讀：FREQ=DAILY; BYHOUR=8; BYMINUTE=30 一眼看懂。
• 時區感知：支援 TIMEZONE，跨 DST 自動調整。
• 彈性：BYMONTHDAY=1,-1 (月初/月末)、BYDAY=MON,TUE、BYHOUR=0-23 任意組合。
• 監控：SELECT * FROM DBA_SCHEDULER_JOB_RUN_DETAILS WHERE JOB_NAME='...';
• 錯誤處理：MAX_RUNS, MAX_FAILURES, RESTARTABLE。
• 鏈式作業：DBMS_SCHEDULER.CREATE_CHAIN 定義前後依賴。

常用 SCHEDULER 監控查詢

-- 執行歷程
SELECT log_date, status, error#, run_duration
FROM dba_scheduler_job_run_details
WHERE job_name = 'RAIN_JM_DAILY'
ORDER BY log_date DESC;

-- 當前執行中
SELECT * FROM dba_scheduler_running_jobs WHERE job_name = 'RAIN_JM_DAILY';

-- 啟用/停用
EXEC DBMS_SCHEDULER.ENABLE('RAIN_JM_DAILY');
EXEC DBMS_SCHEDULER.DISABLE('RAIN_JM_DAILY');

遷移檢查清單

• [ ] 列出所有 DBA_JOBS 並記錄 WHAT, INTERVAL。
• [ ] 對照上表轉換為 REPEAT_INTERVAL 曆法語意。
• [ ] 建立 DBMS_SCHEDULER Job，設定 AUTO_DROP=FALSE。
• [ ] 測試環境驗證執行時間、日誌、錯誤處理。
• [ ] 生產環境切換：DBMS_JOB.BROKEN(job_no, TRUE) 停用舊 Job → 啟用 Scheduler Job。

拋棄難維護的字串間隔，擁抱 DBMS_SCHEDULER 的曆法語意與企業級功能，是 Oracle 排程現代化的必經之路。