DBAtlas · Атлас эксплуатации баз данных

Создать, запустить вручную, отключить и удалить задание планировщика

OracleПланировщик

Команда

-- 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);

Что делает

Определяет запланированное PL/SQL-задание через DBMS_SCHEDULER; задаёт max_run_duration (при превышении генерирует событие) и подробный уровень журналирования, заранее проверяет календарное выражение и позволяет запустить задание вручную, не нарушая расписание.

Когда использовать

Чтобы выполнять регулярные работы в базе, такие как обслуживание, ETL и очистка, внутри базы данных вместо cron, с учётом RAC/Data Guard.

Внимание

Дополнительная лицензия не нужна. Часовой пояс start_date важен: SYSTIMESTAMP использует TZ сервера базы данных; указывайте явный регион (например, 'Europe/Istanbul'), чтобы избежать сдвига при переходе на летнее/зимнее время. Если JOB_QUEUE_PROCESSES=0, ни одно задание не выполняется. DISABLE с force=>TRUE не останавливает уже выполняющийся запуск, а лишь предотвращает будущие; для прерывания используйте STOP_JOB. Создание задания в другой схеме требует CREATE ANY JOB.

Открыть в DBAtlas →

Связанные материалы