OracleCronSchedule

Projeto PL/SQL (ORACLE) para execução de tarefas agendadas. Baseado no CRON/CRONTAB(UNIX).
Projeto para suprir o gerenciamento de JOBS/SCHEDULES do banco de dados ORACLE (10g).

Instalação

Para instalar, basta executar o script install.sql (localizado na raiz do projeto). Serão criadas duas tabelas (GE_AGENDAMENTO, GE_AGENDAMENTO_LOG) com suas devidas Sequences, uma Package (PKG_CRON) e uma JOB com o intervalo mínimo de um minuto trunc(sysdate,'mi') + 1/1440

Uso

Para agendar uma tarefa o usuário deve inserir um registro na tabela GE_AGENDAMENTO. Aqui ele preencherá o comando e a frequência com que o mesmo irá ser executado. Há também possibilidade de inativar e ativar tarefas a qualquer momento.

O preenchimento de cada campo é feito da seguinte maneira:

• Minutos: informe números de 0 a 59;
• Horas: informe números de 0 a 23, sendo 0 meia-noite;
• Dias do mês: informe números de 0 a 31;
• Mês: informe números de 1 a 12, sendo 1 janeiro e 12 dezembro;
• Dias da semana: informe números de 1 a 7, sendo 1 domingo e 7 sábado;
• Comando: a tarefa que deve ser executada.

No lugar desses valores, você pode informar * (asterisco) para especificar uma execução constante. Por exemplo, se o campo dias do mês conter *, o comando relacionado será executado todos os dias.

Você também pode informar intervalos no preenchimento, separando os números de início e fim através de - (hífen). Por exemplo, se no campo horas for informando 2-5, o comando relacionado será executado às 2, 3, 4 e 5 horas. E se o comando tiver que ser executado às 2 horas, entre 15 e 18 horas e às 22 horas? Basta informar 2,15-18,22. Nestes casos, você separa os parâmetros por vírgula.

O acompanhamento da execução de cada processo/tarefa, pode ser visto na tabela GE_AGENDAMENTO_LOG.

Exemplo

Agendar um processo que parabeniza os aniversariantes do mês. Deve ser processado cada dia primeiro, as 10 horas e 30 minutos.

insert into ge_agendamento
	(sq_agendamento,
	 ds_agendamento,
	 ds_statment,	 	 	 
	 meses,
   dias_do_mes,
   dias_da_semana,
   horas,
   minutos,
	 dt_usuinc,
	 nm_usuinc,
	 st_ativo)
values
	(sq_ge_agendamento.nextval,
   'Parabeniza Aniversariantes do mês',
   'BEGIN procedimento(); END;',
   '*',
   '1',
   '*',
   '10',
   '30',
   sysdate,
   'Usuario',
   1);
```

Agendar um processo realiza um backup e restore. Deve ser executado no dias 1, 10, 20 e entre o 28 e 30 de cada mês, a meia-noite e ao meio dia, no primeiro minuto. A menos que seja fim de semana.

````sql
insert into ge_agendamento
	(sq_agendamento,
	 ds_agendamento,
	 ds_statment,	 	 	 
	 meses,
   dias_do_mes,
   dias_da_semana,
   horas,
   minutos,
	 dt_usuinc,
	 nm_usuinc,
	 st_ativo)
values
	(sq_ge_agendamento.nextval,
   'Backup/Restore',
   'BEGIN procedimento(); END;',
   '*',
   '1,10,20,28-30',
   '1-5',
   '0,12',
   0,
   sysdate,
   'Usuario',
   1);
```


# License
Copyright (c) 2016 Linepack
[MIT License] (https://github.com/Linepack/OracleCronSchedule/blob/master/LICENSE)