Jobs

Há cinco opções disponíveis no menu Jobs: Resumo, Execução, Previsão, Histórico, Notificações. Cada opção é descrita abaixo.

Resumo

Na parte superior, a página Resumo fornece uma visão geral do número total de jobs com Falha, Bloqueado, Cadeia interrompida, Recurso indisponível, Interrompido e Repetir Agendamento. Clique em um bloco de jobs e a lista correspondente de jobs será exibida no formato tabular abaixo. Remova os filtros para exibir todos os jobs programados.

Para criar um job, consulte Criar ou Editar Job.

O ícone Ações está disponível no final de cada linha de cargo. Clique em Ações para exibir a seguinte lista de opções:

  • Job
    • Executar: Executa o job específico.

    • Editar: Consulte Criar ou Editar Job.

    • Eliminar: Elimina o job específico.

    • Cargo - Ativar/Desativar: Se ativado estiver selecionado, o job será selecionado pelo Programador para processamento. O status do job (ativado ou não) é visto na página Detalhes do Job, na qual a propriedade "ativado" exibe VERDADEIRO ou FALSO.

  • Histórico
    • Relatório: Fornece um histórico das execuções de job em um formato de relatório, incluindo detalhes do log, status da execução, duração da execução, erros, se houver, e assim por diante.

    • Gráfico: Fornece um histórico das execuções de jobs em uma representação de gráfico de barras visuais. A duração da execução e o tempo de CPU usado são apresentados para cada execução. Trabalhos em cadeias são apresentados com informações agregadas para todo o trabalho. Há uma barra de rolagem de visão geral que permite zoom e rolagem alterando o intervalo de tempo. Você pode exibir todos os detalhes dos logs desse período para um job selecionado ou para todos os jobs. Além disso, um gráfico de Gantt pode ser mostrado para todos os jobs de um período selecionado.

      Esta imagem mostra o histórico das execuções de job em uma representação de barra visual.
  • Previsão da Ordem de Produção: Você pode executar a funcionalidade de previsão da ordem de produção para uma única ordem de produção (disponível no menu Ação) ou para um conjunto de ordens de produção (disponível na barra de ferramentas da tabela). Para um conjunto de jobs, a filtragem pode ser usada para restringir o conjunto de jobs. Use Tecla Ctrl+clique para selecionar alguns jobs e, em seguida, a Previsão do Job será executada apenas para os jobs selecionados. Se não houver jobs selecionados, a previsão será executada para todos os jobs listados. Nem todas as tarefas incluídas no conjunto estão incluídas na previsão final. Somente jobs com um calendário definido (intervalo de repetição) são incluídos. Você pode definir o calendário em linha ou usando programação, janela ou grupo de janelas. Depois que a previsão for concluída, você poderá selecionar diferentes níveis de zoom e filtrar os resultados por esquema.

  • Detalhes do Job: Exibe atributos do job, como ação, classe do job, tipo, programação etc. Selecione JSON para exibir os atributos no formato JSON. Dependendo da definição do job, são fornecidos detalhes sobre objetos usados, como programa usado, código PL/SQL, procedimento, dependências de procedimento, argumentos do programa, argumentos do job, classe do job, programação, janela, grupo de janelas junto com janelas no grupo, observador de arquivos, gráfico de histórico apresentando uma semana de histórico a partir da última data inicial.

Executando

A página Em Execução exibe a lista de jobs em execução no momento. Os seguintes comandos estão disponíveis: Parar, Editar, Histórico, Detalhes do Job.

Histórico

A página Histórico exibe os detalhes da execução de log de todos os jobs do Scheduler disponíveis para o usuário. Você pode usar a janela Histórico e definir filtros para limitar a quantidade de dados. Você pode filtrar usando jobs atrasados fornecendo um intervalo de atraso. A ordenação é suportada na grade clicando no cabeçalho da coluna.

Previsão

A página Previsão fornece a previsão de execução da tarefa para todas as tarefas disponíveis. Essa operação leva tempo para ser concluída, dependendo do número de ordens de produção e do intervalo de previsão. A previsão de todos os jobs disponíveis depende dos direitos do usuário conectado. Após a execução, você pode filtrar os resultados com base no esquema dos jobs.

A funcionalidade Previsão também está disponível na página Resumo de Cargos. Nesse caso, ele funciona na lista de trabalhos disponíveis. Você pode filtrar as tarefas antes que a funcionalidade de previsão seja usada. Se houver uma seleção de cargos, a funcionalidade usará apenas os cargos selecionados.

Histórico (Gráfico de Gantt)

O histórico representa janelas e histórico de execução de jobs na forma de um gráfico de Gantt. O histórico de ativação do Windows é mostrado na primeira linha. Os jobs são ordenados em ordem decrescente com base no tempo máximo de CPU usado. Os detalhes são mostrados para cada ativação de janela e execução de job. O resumo do cargo está disponível ao passar o mouse sobre o rótulo da linha de um cargo.

Esta imagem mostra as janelas e o histórico de execução do job na forma de um gráfico de Gantt.

Notificações

Você só poderá criar notificações se um servidor de e-mail estiver definido para o programador.

A página Notificações permite exibir, criar, editar e excluir notificações relacionadas a eventos de cargo. Além disso, você pode ver os detalhes do servidor de e-mail clicando no ícone Servidor de E-mail de Notificações no canto superior direito da página.

Para cada mensagem, é possível especificar o cargo, os endereços de e-mail do destinatário e o remetente (ou nenhum remetente), além de modificar o assunto e o corpo da mensagem e definir a condição do filtro. Se vários destinatários e eventos forem fornecidos, o Oracle Scheduler criará um registro de notificação separado para cada combinação <recipient,event>. Você pode editar o conteúdo de um conjunto de notificações criadas dessa forma usando Editar Agregado, que aparece no menu de contexto de cada notificação. Editar edita o conteúdo de uma única notificação.

As notificações podem ser filtradas por nome do job, proprietários do job, destinatários e eventos. Você pode selecionar e remover algumas notificações clicando no ícone Remover Notificações. Se não houver notificações selecionadas (use Ctrl+clique para desmarcar uma única notificação), a caixa de diálogo Remover Notificações será exibida permitindo a remoção de todas as notificações para o job selecionado, ou job e destinatários, ou job e eventos, ou job e eventos e destinatários.

Criar ou Editar o Job

Esta seção descreve como criar um novo job do Oracle Scheduler ou editar um job existente.

Para criar um job, o Database Actions usa internamente o procedimento DBMS_SCHEDULER.CREATE_JOB, que é documentado na Referência de Tipos e Pacotes PL/SQL do Oracle Database.

  1. Na página Jobs, no canto superior direito, clique em Criar Job.
  2. Em Propriedades do Job, informe os seguintes campos:

    Detalhes

    • Ativado: Se essa opção for especificada, as verificações de validade serão feitas e o job será criado ativado se todas as verificações forem bem-sucedidas. Se essa opção não for especificada, o job não será criado ativado.
    • Nome: Nome do job.
    • Descrição: String de texto opcional que pode ser usada para descrever o job.
    • Tipo: Tipo de objeto a ser executado pelo job: Bloco PL/SQL, Cadeia, Procedimento Armazenado, Programa Nomeado ou Script. Controles adicionais são exibidos para Cadeia, Procedimento Armazenado e Programa Nomeado, permitindo que você selecione objetos relacionados.

      Para Procedimento Armazenado, somente procedimentos com parâmetros IN são listados, procedimentos com parâmetros IN OUT ou OUT não são permitidos.

      Os procedimentos no nível do esquema e do pacote são listados para o esquema selecionado, mas você pode digitar diretamente o nome do procedimento (ou package_name.procedure_name) no campo.

    • Classe: Nome da classe do job ao qual este job pertence.

    Modo de Execução

    • Mode: When to execute the job: Immediate (immediately on creation, and once only), Once (once, at a specified time), Repeating, Queue, File Watcher, Schedule (using a named schedule object), Window and Window group. Se você especificar algo diferente de Imediato, serão solicitadas informações adicionais.

      Para Repetição, você pode definir manualmente o intervalo de repetição ou clicar no ícone de lápis para selecionar os valores de data, frequência, dia da semana e intervalo. Algumas cláusulas da sintaxe do calendário Oracle (incluir, excluir, cruzar, pontos e por período) não são suportadas e um aviso é exibido quando o ícone de edição é clicado.

    Destino

    • Local (sistema local), Remoto (o destino do banco de dados para um job de banco de dados remoto ou destino externo para um job externo remoto) ou Vários (o job é executado em todos os destinos associados ao grupo de destinos fornecido). Dependendo do destino selecionado para o job, selecione a credencial local, a credencial e o destino remotos ou o grupo de destinos.

    Propriedades

    • Eliminação Automática: Determina se o job deve ser eliminado automaticamente depois de concluído ou desativado automaticamente.

    • Reiniciar em caso de falha: Determina se o job pode ser reiniciado em caso de falha.

    • Reiniciar na recuperação: Determina se o job deve ser reiniciado em caso de falha do banco de dados.

    • Armazenar Saída: Se ativada, para execuções de job registradas em log, todas as mensagens de saída e erro do job serão armazenadas nas views *_JOB_RUN_DETAILS. Se desativado, a saída e as mensagens não serão armazenadas.

    • Seguir Fuso Horário Padrão: Determina se a data inicial do job é nula e, quando o atributo do programador de fuso horário padrão é alterado, o Programador recalcula a próxima data e hora de execução deste job para que ele esteja de acordo com o novo fuso horário.

    • Permitir Execuções no Modo Restrito: Se ativado, o job terá permissão para ser executado quando o banco de dados estiver no modo restrito, desde que o proprietário do job tenha permissão para fazer log-in durante esse modo.
    • Interromper no Fechamento da Janela: Se a programação de uma ordem de produção for uma janela ou um grupo de janelas, a ativação dessa opção fará com que a ordem de produção seja interrompida quando a janela associada for fechada e a desativação fará com que a ordem de produção continue após o fechamento da janela. (Observe que, se a tarefa tiver permissão para continuar, sua alocação de recursos provavelmente será alterada porque o fechamento de uma janela geralmente também implica uma alteração nos planos de recursos.)

    • Persistência na Instância: Este atributo só deve ser usado para um banco de dados em execução em um ambiente do Oracle Real Application Clusters (Oracle RAC). Por padrão, ela está ativada. Os jobs começam a ser executados na instância com a carga mais leve e, posteriormente, o Scheduler tenta ser executado na instância na qual ela foi executada pela última vez. Se essa instância estiver inativa ou tão sobrecarregada que não inicie novos jobs por um período significativo, outra instância executará o job. Se o intervalo entre execuções for grande, instance_stickiness será ignorado e o job será tratado como se fosse um job não persistente. Se instance_stickiness estiver desativado, cada instância do job será executada na primeira instância disponível.
    • Instâncias Paralelas: Para um job baseado em evento, determina o que acontecerá se um evento for gerado e o job baseado em evento que processa esse evento já estiver em execução. Se desativado, o novo evento será ignorado. Se ativada, ela fará com que uma instância do job seja iniciada para cada instância do evento, e cada instância do job é um job leve para que várias instâncias do mesmo job baseado em evento possam ser executadas em paralelo.

    • Estilo do Job: Estilo do job que está sendo criado: REGULAR (job REGULAR) ou LIGHTWEIGHT (job leve). Um peso leve deve fazer referência a um objeto de programa. Use jobs leves quando tiver muitos jobs de curta duração executados com frequência. Em determinadas circunstâncias, o uso de empregos leves pode proporcionar um pequeno ganho de desempenho.

    • Prioridade do Job: A prioridade desse job em relação a outros jobs na mesma classe que esse job. Se vários jobs dentro de uma classe estiverem programados para serem executados ao mesmo tempo, a prioridade do job determinará a ordem na qual os jobs dessa classe são selecionados para execução pelo coordenador do job. Pode ser um valor de 1 a 5, sendo 1 o primeiro a ser selecionado para execução do job.

    • Nível de Log: Determina quantas informações são registradas em log: DBMS_SCHEDULER.LOGGING_OFF (sem log), DBMS_SCHEDULER.LOGGING_FAILED_RUNS (somente jobs que falharam, com o motivo da falha), DBMS_SCHEDULER.LOGGING_RUNS (todas as execuções de cada job nesta classe) ou DBMS_SCHEDULER.LOGGING_FULL (todas as operações executadas em todos os jobs).

      No entanto, se a classe de job tiver um nível de log mais alto (mais detalhado) do que o nível especificado para o job, o nível de log da classe de job será usado.

    • ID da Instância: Em um ambiente do Oracle Real Application Clusters, o ID da instância na qual o job deve ser executado.

    • Máximo de Execuções: O número máximo de execuções programadas consecutivas do job.

    • Máximo de Falhas: O número de vezes que um job pode falhar em execuções programadas consecutivas antes de ser automaticamente desativado.

    • Emitir Eventos: Determina em quais estágios da execução do job gerar eventos.

    • Duração Máxima da Execução: Tempo máximo que o job deve ter permissão para ser executado. Seu tipo de dados é INTERVAL DAY TO SECOND. Se esse atributo for definido como um valor diferente de zero e não nulo e a duração do job exceder esse valor, o Scheduler gerará um evento do tipo JOB_OVER_MAX_DUR. Em seguida, cabe ao processador de eventos decidir se a tarefa deve ou não continuar.

    • Limite de Programação: Tempo máximo de atraso entre o início do job programado e real antes que uma execução do programa seja cancelada.

    • Redefinir para Padrões: Redefine todas as propriedades para seus valores padrão.

    NLS

    Permite definir a propriedade relacionada ao NLS necessária para este job. Para informar um valor, digite o campo relacionado da coluna Valor.

    Para um novo job, os parâmetros são obtidos da sessão do banco de dados.

  3. No painel DDL, você pode revisar e salvar as instruções SQL geradas ao criar ou editar o job.
    • Para um novo job, clique em CREATE para exibir as instruções DDL geradas.

    • Ao editar um job, clique em UPDATE para exibir as instruções ALTER geradas.

    Ao concluir, clique em Aplicar.

    O painel Saída exibe os resultados dos comandos DDL. Se houver algum erro, vá para o painel correspondente, corrija os erros e execute os comandos novamente. Você pode salvar o conteúdo em um arquivo.