Trabajos

Hay cinco opciones disponibles en el menú Trabajos: Resumen, Ejecución, Previsión, Historial, Notificaciones. Cada opción se describe a continuación.

Resumen

En la parte superior, la página Summary proporciona una visión general del número total de trabajos con fallos, bloqueados, paralizados en cadena, no disponibles en el recurso, rotos y reintentos programados. Haga clic en un mosaico de trabajo y la lista correspondiente de trabajos se mostrará en formato tabular a continuación. Elimine los filtros para mostrar todos los trabajos programados.

Para crear un trabajo, consulte Creación o edición de trabajo.

El icono Acciones está disponible al final de cada fila de trabajo. Haga clic en Acciones para ver la siguiente lista de opciones:

  • Trabajo
    • Ejecutar: ejecuta el trabajo específico.

    • Editar: consulte Crear o editar trabajo.

    • Borrar: borra el trabajo específico.

    • Job-Enable/Disable: si está activado, el programador selecciona el trabajo para su procesamiento. El estado del trabajo (activado o no) se muestra en la página Detalles del trabajo, donde la propiedad "activado" muestra TRUE o FALSE.

  • History
    • Informe: proporciona un historial de las ejecuciones de trabajos en formato de informe, incluidos los detalles del log, el estado de la ejecución, la duración de la ejecución, los errores, si los hay, etc.

    • Gráfico: proporciona un historial de las ejecuciones de trabajos en una representación de gráfico de barras visual. La duración de ejecución y el tiempo de CPU utilizado se presentan para cada ejecución. Los trabajos en cadenas se presentan con información agregada para todo el trabajo. Hay una barra de desplazamiento de visión general que permite ampliar y desplazar cambiando el periodo de tiempo. Puede mostrar todos los detalles de los logs de ese período de tiempo para un trabajo seleccionado o para todos los trabajos. Además, se puede mostrar un gráfico de Gantt para todos los trabajos de un periodo de tiempo seleccionado.

      En esta imagen se muestra el historial de ejecuciones de trabajos en una representación de barra visual.
  • Previsión de trabajos: puede ejecutar la funcionalidad de previsión de trabajos para un único trabajo (disponible en el menú Acción) o para un juego de trabajos (disponible en la barra de herramientas de la tabla). Para un juego de trabajos, el filtrado se puede utilizar para restringir el juego de trabajos. Utilice Ctrl + clic para seleccionar algunos trabajos y, a continuación, la previsión de trabajos se ejecutará solo para los trabajos seleccionados. Si no hay trabajos seleccionados, se ejecutará la previsión para todos los trabajos mostrados. No todos los trabajos incluidos en el juego se incluyen en la previsión final. Solo se incluyen los trabajos con un calendario definido (intervalo de repetición). Puede definir el calendario en línea o mediante programa, ventana o grupo de ventanas. Una vez realizada la previsión, puede seleccionar diferentes niveles de zoom y filtrar los resultados por esquema.

  • Detalles del trabajo: muestra atributos de trabajo, como acción, clase de trabajo, tipo, programación, etc. Seleccione JSON para ver los atributos en formato JSON. En función de la definición del trabajo, se proporcionan detalles sobre los objetos utilizados, como programa utilizado, código PL/SQL, procedimiento, dependencias de procedimientos, argumentos de programa, argumentos de trabajo, clase de trabajo, programa, ventana, grupo de ventanas junto con ventanas del grupo, observador de archivos, gráfico de historial que presenta una semana de historial desde la última fecha de inicio.

En ejecución

La página Running muestra la lista de trabajos actualmente en ejecución. Están disponibles los siguientes comandos: Stop, Edit, History, Job Details.

History

La página History muestra los detalles de ejecución de log de todos los trabajos del programador disponibles para el usuario. Puede utilizar la ventana Historial y definir filtros para limitar la cantidad de datos. Puede filtrar mediante trabajos retrasados proporcionando un intervalo de retraso. El orden se admite en la cuadrícula haciendo clic en el encabezado de columna.

Previsión

La página Previsión proporciona la previsión de ejecución de trabajos para todos los trabajos disponibles. Esta operación tarda en terminar en función del número de trabajos y del intervalo de previsión. La previsión de todos los trabajos disponibles depende de los derechos del usuario de conexión. Después de la ejecución, puede filtrar los resultados según el esquema de los trabajos.

La funcionalidad Previsión también está disponible en la página Jobs - Summary. En ese caso, funciona en la lista de trabajos disponibles. Puede filtrar los trabajos antes de utilizar la funcionalidad de previsión. Si hay una selección de trabajos, la funcionalidad solo utiliza los trabajos seleccionados.

Historial (gráfico de Gantt)

El historial representa las ventanas y el historial de ejecución de trabajos en forma de gráfico de Gantt. El historial de activación de Windows se muestra en la primera fila. Los trabajos se ordenan en orden descendente según el tiempo máximo de CPU utilizado. Se muestran detalles para cada activación de ventana y ejecución de trabajo. El resumen de trabajo está disponible al pasar el mouse sobre la etiqueta de la fila de un trabajo.

En esta imagen se muestran las ventanas y el historial de ejecución de trabajos en forma de gráfico de Gantt.

Notifications

Puede crear notificaciones solo si se ha definido un servidor de correo electrónico para el programador.

La página Notificaciones permite ver, crear, editar y suprimir notificaciones relacionadas con eventos de puesto. Además, puede ver los detalles del servidor de correo electrónico haciendo clic en el icono Servidor de correo electrónico de notificaciones en la parte superior derecha de la página.

Para cada mensaje, puede especificar el trabajo, las direcciones de correo electrónico del destinatario y el remitente (o ningún remitente), y puede modificar el asunto y el cuerpo del mensaje y definir la condición de filtro. Si se proporcionan varios destinatarios y eventos, Oracle Scheduler crea un registro de notificación independiente para cada combinación <recipient,event>. Puede editar el contenido de un juego de notificaciones creado de esta forma mediante Editar agregado, que aparece en el menú contextual de cada notificación. Editar edita el contenido de una única notificación.

Las notificaciones se pueden filtrar por nombre de puesto, responsables de puesto, destinatarios y eventos. Puede seleccionar y eliminar algunas notificaciones haciendo clic en el icono Eliminar notificaciones. Si no hay ninguna notificación seleccionada (use Ctrl+clic para anular la selección de una única notificación), aparece el cuadro de diálogo Eliminar notificaciones, que activa la eliminación de todas las notificaciones para el trabajo seleccionado, o el trabajo y los destinatarios, o el trabajo y los eventos, o el trabajo y los eventos y destinatarios.

Crear o editar trabajo

En esta sección se describe cómo crear un nuevo trabajo de Oracle Scheduler o editar un trabajo existente.

Para crear un trabajo, Database Actions utiliza internamente el procedimiento DBMS_SCHEDULER.CREATE_JOB, que se documenta en Referencia de tipos y paquetes PL/SQL de Oracle Database.

  1. En la página Trabajos, en la parte superior derecha, haga clic en Crear trabajo.
  2. En Propiedades de trabajo, introduzca los siguientes campos:

    Detalles

    • Activado: si se especifica esta opción, se realizan comprobaciones de validez y el trabajo se crea activado si todas las comprobaciones se realizan correctamente. Si no se especifica esta opción, el trabajo no se crea activado.
    • Nombre: nombre del trabajo.
    • Descripción: cadena de texto opcional que se puede utilizar para describir el trabajo.
    • Tipo: tipo de objeto que ejecutará el trabajo: bloque PL/SQL, cadena, procedimiento almacenado, programa con nombre o script. Aparecen controles adicionales para Cadena, Procedimiento almacenado y Programa designado que permiten seleccionar objetos relacionados.

      En Procedimiento almacenado, solo se muestran los procedimientos con parámetros IN, no se permiten los procedimientos con parámetros IN OUT o OUT.

      Se muestran los procedimientos de nivel de esquema y nivel de paquete para el esquema seleccionado, pero puede escribir directamente el nombre del procedimiento (o package_name.procedure_name) en el campo.

    • Clase: nombre de la clase de trabajo a la que pertenece este trabajo.

    Modo de Ejecución

    • 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. Si especifica algo distinto de Immediate, se le pedirá información adicional.

      En Repetición, puede definir manualmente el intervalo de repetición o hacer clic en el icono de lápiz para seleccionar los valores de fecha, frecuencia, día de la semana e intervalo. Algunas cláusulas de la sintaxis de calendario de Oracle (incluir, excluir, intersectar, puntos y por período) no están soportadas y se muestra una advertencia cuando se hace clic en el icono de edición.

    Destino

    • Local (sistema local), Remoto (destino de base de datos para un trabajo de base de datos remoto o destino externo para un trabajo externo remoto) o Varios (el trabajo se ejecuta en todos los destinos asociados con el grupo de destinos proporcionado). Según el destino que haya seleccionado para el trabajo, seleccione la credencial local, la credencial remota y el destino, o el grupo de destino.

    Propiedades

    • Borrado automático: determina si el trabajo se borrará automáticamente una vez finalizado o desactivado automáticamente.

    • Reiniciar en caso de fallo: determina si el trabajo se puede reiniciar en caso de fallo.

    • Reiniciar en recuperación: determina si se debe reiniciar el trabajo en caso de fallo de la base de datos.

    • Almacenar salida: si está activado, para las ejecuciones de trabajos que se registran, todas las salidas de trabajo y los mensajes de error se almacenan en las vistas *_JOB_RUN_DETAILS. Si se desactiva, la salida y los mensajes no se almacenan.

    • Seguir zona horaria por defecto: determina si la fecha de inicio del trabajo es nula y, a continuación, cuando se cambia el atributo del programador de zona horaria por defecto, el programador vuelve a calcular la siguiente fecha y hora de ejecución de este trabajo para que se ajuste a la nueva zona horaria.

    • Permitir ejecuciones en modo restringido: si está activado, el trabajo se puede ejecutar cuando la base de datos está en modo restringido, siempre que el propietario del trabajo tenga permiso para conectarse durante este modo.
    • Parar al cerrar la ventana: si la planificación de un trabajo es una ventana o un grupo de ventanas, la activación de esta opción hace que el trabajo se pare una vez que se cierre la ventana asociada y la desactivación hace que el trabajo continúe después de que se cierre la ventana. (Tenga en cuenta que si se permite que el trabajo continúe, su asignación de recursos probablemente cambiará porque cerrar una ventana generalmente también implica un cambio en los planes de recursos).

    • Persistencia de instancia: este atributo solo se debe utilizar para una base de datos que se ejecute en un entorno de Oracle Real Application Clusters (Oracle RAC). Está activada por defecto. Los trabajos comienzan a ejecutarse en la instancia con la carga más ligera y, a partir de entonces, el programador intenta ejecutarse en la instancia en la que se ejecutó por última vez. Si esa instancia está caída o tan sobrecargada que no inicia nuevos trabajos durante un período de tiempo significativo, otra instancia ejecuta el trabajo. Si el intervalo entre ejecuciones es grande, se ignora instance_stickiness y el trabajo se maneja como si se tratara de un trabajo no permanente. Si instance_stickiness está desactivado, cada instancia del trabajo se ejecuta en la primera instancia disponible.
    • Instancias paralelas: para un trabajo basado en eventos, determina qué sucede si se inicia un evento y el trabajo basado en eventos que procesa ese evento ya se está ejecutando. Si se desactiva, se ignora el nuevo evento. Si se activa, hace que se inicie una instancia del trabajo para cada instancia del evento, y cada instancia de trabajo es un trabajo sencillo para que se puedan ejecutar en paralelo varias instancias del mismo trabajo basado en eventos.

    • Estilo de trabajo: estilo del trabajo que se está creando: REGULAR (trabajo normal) o LIGHTWEIGHT (trabajo ligero). Un objeto ligero debe hacer referencia a un objeto de programa. Utilice trabajos sencillos cuando tenga muchos trabajos de corta duración que se ejecuten con frecuencia. Bajo ciertas circunstancias, el uso de trabajos ligeros puede ofrecer una pequeña ganancia de rendimiento.

    • Prioridad de trabajo: prioridad de este trabajo en relación con otros trabajos de la misma clase que este trabajo. Si varios trabajos de una clase están programados para ejecutarse al mismo tiempo, la prioridad del trabajo determina el orden en el que los trabajos de esa clase son seleccionados para su ejecución por el coordinador de trabajos. Puede ser un valor del 1 al 5, siendo 1 el primero en seleccionarse para la ejecución del trabajo.

    • Nivel de registro: determina la cantidad de información que se registra: DBMS_SCHEDULER.LOGGING_OFF (sin registro), DBMS_SCHEDULER.LOGGING_FAILED_RUNS (solo trabajos que han fallado, con el motivo del fallo), DBMS_SCHEDULER.LOGGING_RUNS (todas las ejecuciones de cada trabajo de esta clase) o DBMS_SCHEDULER.LOGGING_FULL (todas las operaciones realizadas en todos los trabajos).

      Sin embargo, si la clase de trabajo tiene un nivel de registro más alto (más detallado) que el especificado para el trabajo, se utiliza el nivel de registro de la clase de trabajo.

    • ID de instancia: en un entorno de Oracle Real Application Clusters, el ID de instancia de la instancia en la que se debe ejecutar el trabajo.

    • Máximo de ejecuciones: número máximo de ejecuciones programadas consecutivas del trabajo.

    • Máximo de fallos: número de veces que un trabajo puede fallar en ejecuciones planificadas consecutivas antes de que se desactive automáticamente.

    • Generar eventos: determina en qué etapas de la ejecución del trabajo se generan eventos.

    • Duración máxima de ejecución: cantidad máxima de tiempo que se debe permitir la ejecución del trabajo. Su tipo de dato es INTERVAL DAY TO SECOND. Si este atributo se define en un valor distinto de cero y no nulo, y la duración del trabajo supera este valor, el programador emite un evento de tipo JOB_OVER_MAX_DUR. A continuación, depende del manejador de eventos decidir si se permite o no que el trabajo continúe.

    • Límite de programa: tiempo de retraso máximo entre el inicio de trabajo programado y real antes de que se cancele la ejecución de un programa.

    • Restablecer a valores por defecto: restablece todas las propiedades a sus valores por defecto.

    NLS

    Permite definir la propiedad relacionada con NLS necesaria para este trabajo. Para introducir un valor, escriba en el campo relacionado de la columna Valor.

    Para un nuevo trabajo, los parámetros se toman de la sesión de base de datos.

  3. En el panel DDL, puede revisar y guardar las sentencias SQL que se generan al crear o editar el trabajo.
    • Para un nuevo trabajo, haga clic en CREAR para ver las sentencias DDL generadas.

    • Al editar un trabajo, haga clic en UPDATE para ver las sentencias ALTER generadas.

    Cuando termine, haga clic en Aplicar.

    El panel Salida muestra los resultados de los comandos DDL. Si hay algún error, vaya al panel correspondiente, corrija los errores y vuelva a ejecutar los comandos. Puede guardar el contenido en un archivo.