Jobs

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

• Resumo
  
• Processando
  
• Histórico
  
• Previsão
  
• Histórico (Gráfico de Gantt)
  
• Notificações
  
• Criar ou Editar Vaga
  

Resumo

Na parte superior, a página Resumo fornece uma visão geral do número total de jobs com Falha, Bloqueado, Paralisado na Cadeia, Recurso indisponível, Interrompido e Repetir Agendados. 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:

• Cargo

  • Executar: Executa o job específico.

  • Editar: Consulte Criar ou Editar Job.

  • Eliminar: Elimina o job específico.

  • Ativar/Desativar Job: se esta opção estiver selecionada, o job será selecionado pelo Scheduler para processamento. O status do job (ativado ou não) é visto na página Detalhes do Job, na qual a propriedade "ativado" exibe TRUE ou FALSE.

• Histórico

  • Relatório: Fornece um histórico das execuções de job em um formato de relatório, incluindo detalhes de 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 job 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. Empregos em cadeias são apresentados com informações agregadas para todo o trabalho. Há uma barra de rolagem de visão geral que permite ampliar e rolar alterando o período. Você pode exibir todos os detalhes dos logs desse período de tempo para um job selecionado ou para todos os jobs. Além disso, um gráfico de Gantt pode ser mostrado para todos os trabalhos de um período selecionado.

    
    Descrição da ilustração history_chart_gantt.png

• Previsão de Job: Você pode executar a funcionalidade de previsão de job para um único job (disponível no menu Ação) ou para um conjunto de jobs (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 Ctrl key+click para selecionar alguns jobs e, em seguida, a Previsão de Jobs será executada apenas para os jobs selecionados. Se não houver jobs selecionados, a previsão será executada para todos os jobs listados. Nem todos os trabalhos incluídos no conjunto são incluídos 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, detalhes sobre objetos usados são fornecidos, 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 que apresenta uma semana de histórico 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: Interromper, Editar, Histórico, Detalhes do trabalho.

Histórico

A página Histórico exibe detalhes de 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 o volume 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 do job para todos os jobs 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 para todos os trabalhos 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 Caso também está disponível em Cargos – página Resumo. Nesse caso, ele funciona na lista de trabalhos disponíveis. Você pode filtrar os cargos antes que a funcionalidade de previsão seja usada. Se houver uma seleção de cargos, a funcionalidade usará apenas os cargos selecionados.

Descrição da ilustração forecast.png

Histórico (Gráfico de Gantt)

O histórico representa janelas e histórico de execução de job 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 fica disponível ao passar o mouse sobre o rótulo da linha do cargo.

Notificações

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

A página Notificações permite que você exiba, crie, edite e exclua notificações relacionadas a eventos de job. 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), bem como 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 <recipiente,evento>. 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+click 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.

Descrição da ilustração remove_notifications.png

Criar ou Editar Cargo

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 em Oracle Database PL/SQL Packages and Types Reference.

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 esta 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 esta 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 em nível de esquema e de 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 de job à qual este job pertence.

   Modo de Execução

   • Modo: Quando executar o job: Imediato (imediato na criação e apenas uma vez), Uma Vez (uma vez, em um horário especificado), Repetição, Fila, Observador de Arquivos, Programação (usando um objeto de programação nomeado), Janela e Grupo de janelas. Se você especificar algo diferente de Imediato, será solicitado a fornecer 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, períodos 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 o destino externo para um job externo remoto) ou Vários (o job é executado em todos os destinos associados ao grupo de destino fornecido). Dependendo de qual destino você selecionou 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 após sua conclusão ou ser 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 será reiniciado em caso de falha do banco de dados.

   • Armazenar Saída: Se ativada, para execuções de job registradas, todas as saídas de job e mensagens de erro serão armazenadas nas exibições *_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, quando o atributo do scheduler de fuso horário padrão é alterado, o Scheduler recalcula a próxima data e hora de execução para este job, de modo que ele esteja de acordo com o novo fuso horário.

   • Permitir Execuções no Modo Restrito: Se ativado, o job poderá 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 um job for uma janela ou um grupo de janelas, ativar essa opção fará com que o job seja interrompido quando a janela associada for fechada e desativar fará com que o job continue após o fechamento da janela. (Observe que, se o job tiver permissão para continuar, sua alocação de recursos provavelmente será alterada porque fechar uma janela geralmente também implica uma alteração nos planos de recursos.)

   • Persistência da 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, ele é desativado. Os jobs começam a ser executados na instância com a carga mais leve e, em seguida, o Scheduler tenta ser executado na instância em que foi executado pela última vez. Se essa instância estiver inativa ou sobrecarregada de modo 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-sticky. 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 acontece se um evento for gerado e o job baseado em evento que processa esse evento já está em execução. Se desabilitado, 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 será um job leve para que várias instâncias do mesmo job baseado em evento possam ser executadas em paralelo.

   • Estilo da Ordem de Produção: Estilo da ordem de produção que está sendo criada: REGULAR (ordem de produção REGULAR) ou LIGHTWEIGHT (ordem de produção leve). Um peso leve deve fazer referência a um objeto de programa. Use jobs leves quando tiver muitos jobs de curta duração que são executados com frequência. Em certas circunstâncias, o uso de trabalhos leves pode proporcionar um pequeno ganho de desempenho.

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

   • Nível de Log: Determina o volume de informações registradas: 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 consecutivas programadas antes de ele ser desativado automaticamente.

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

   • Duração Máxima da Execução: o tempo máximo que o job deve ter permissão para executar. 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 da tarefa exceder esse valor, o Programador gerará um evento do tipo JOB_OVER_MAX_DUR. Cabe ao processador de eventos decidir se deseja ou não permitir que o trabalho continue.

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

   • Redefinir como Defaults: redefine todas as propriedades para seus valores default.

   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.

   Quando terminar, 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.