Programar una tarea de notebook

Puede crear tareas para programar la ejecución automática de un notebook. Siempre que su notebook se ejecute según la programación que defina, el sitio abre un contenedor nuevo y ejecuta el notebook sin tener que abrir el notebook usted. Puede haber un máximo de cinco tareas en ejecución al mismo tiempo en todos los notebooks de su propiedad.

Desde el panel Tareas del editor de notebooks, puede crear una o varias tareas programadas para ejecutar el notebook. Puede programarlo para que se ejecute una vez en el futuro o de forma recurrente, desde una vez cada 15 minutos hasta una vez cada 6 meses.

Si va a preparar un notebook para la ejecución automática, por ejemplo de forma periódica, existen algunos aspectos que debe tener en cuenta.

Preparar su notebook

El programador brinda la opción de insertar parámetros como una nueva celda en el momento de la ejecución, como credenciales de la cuenta o variables a definir.

La operación usa la opción de la barra de herramientas de la celda Etiquetas, que permite crear y administrar etiquetas para cada celda en el espacio de trabajo del notebook. Puede cambiar las opciones de la barra de herramientas de la celda haciendo clic en Vista y seleccionando Barra de herramientas de la celda.

Puede designar el lugar del notebook donde se coloca esta nueva celda agregando la etiqueta injected-parameters a una celda del notebook. La celda nueva se inserta tras esta celda. La operación solo reconoce una celda con la etiqueta injected-parameters.

Consideraciones sobre su contenido

Aparte de los parámetros de celda que puede insertar, la programación de un notebook no admite ninguna interacción de los usuarios con los notebooks. Evite añadir contenido que requiera la interacción del usuario mientras se ejecuta el notebook, como hacer clic en un punto de un mapa.

Cualquier credencial o variable nueva que quiera añadir durante la ejecución automática debe insertarse en la celda de parámetros, tal como se muestra arriba. Asegúrese de que el notebook no incluya contenido que impida que se complete.

Crear una tarea

Cuando su notebook esté listo, puede crear una tarea para programar su ejecución. Con el panel Tareas del editor de notebooks, puede crear una o varias tareas para automatizar la ejecución del notebook, así como especificar la programación de la tarea.

  1. Compruebe que ha iniciado sesión con privilegios para crear y programar notebooks.
  2. Guarde el notebook con un título, si todavía no lo ha hecho.

    El botón Tareas pasa a estar disponible en la cinta superior del editor de notebooks.

  3. En la cinta superior del editor de notebooks, haga clic en Tareas.
  4. Haga clic en Crear tarea para abrir el cuadro de diálogo.

    Nota:
    También puede crear tareas desde la pestaña Tareas de la página de detalles del elemento del notebook.

  5. Proporcione un título en el cuadro de texto Título para describir el programa de tareas, como Ejecución de limpieza de datos semanal.
  6. Si hay algún parámetro que desee agregar al notebook cuando la tarea lo ejecute, proporciónelo en la sección Parámetros. Asigne una clave en el ajuste Clave y su valor vinculado en el ajuste Valor para cada parámetro y haga clic en Agregar parámetro para guardar el parámetro.

    Tras agregar al menos un parámetro, aparece la opción Guardar parámetros en el notebook. Si esta opción está activada, la celda insertada con el nuevo parámetro se guarda en el notebook cuando se ejecute.

  7. Haga clic en Siguiente.
  8. En la página Definir detalles de programación de tarea, especifique el programa para la tarea.

    Sugerencia:
    Si cambia el valor de Tipo de repetición, las opciones que aparecen a continuación cambian para adaptarse a esa denominación. Por ejemplo, si elige Semana, aparecen casillas de verificación para cada día de la semana.

  9. Use el botón de alternancia de Actualizar notebook al terminar para elegir si guardar o no el notebook después de cada ejecución realizada. Si desea actualizar el notebook con los resultados de cada ejecución, active el botón de alternancia. Si no desea que el notebook se actualice automáticamente, desactive el botón de alternancia.
  10. Cuando esté conforme con el título, los parámetros opcionales y la programación de la tarea, haga clic en Crear tarea.

    La tarea está activa y ejecuta el notebook según la programación que haya definido.

Si desea tener varias programaciones, puede crear más tareas para el notebook con el mismo flujo de trabajo. Puede haber un máximo de cinco tareas en ejecución al mismo tiempo en todos los notebooks de su propiedad. Las tareas programadas para iniciarse cuando ya hay cinco tareas en curso se marcan como fallidas.

Trabajar con tareas existentes

Una vez que ha creado una tarea para su notebook, puede ver sus detalles, editarla o eliminarla en cualquier momento. Puede hacer cambios en las tareas desde el panel Tareas del editor de notebooks o desde la pestaña Tareas de la página de detalles del elemento del notebook. En ambas ubicaciones puede ver todas las tareas del notebook con la hora de su creación y su última modificación, así como su estado actual.

  1. Compruebe que ha iniciado sesión con privilegios para crear notebooks.
  2. En la cinta superior del editor de notebooks, haga clic en Tareas.
  3. En la sección Tareas programadas, busque la tarea con la que desee trabajar.
  4. Haga clic en Acciones Acciones junto a la tarea y realice una de las siguientes acciones:
    • Haga clic en Detalles para ver los detalles y el estado de cada ejecución de la tarea. Para ver los resultados de la ejecución, haga clic en el botón Resultados. El estado de las tareas puede ser uno de los siguientes:
      • Correcta: la tarea se completó correctamente.
      • En ejecución: la tarea está actualmente en ejecución.
      • Fallida: la tarea no se pudo ejecutar correctamente. Si una tarea falla cinco veces, se detiene completamente.
      • Omitida: la tarea se omitió porque aún estaba en ejecución una ejecución anterior.
    • Haga clic en Editar para cambiar el título, los parámetros o la programación de la tarea.
    • Haga clic en Pausa para pausar una tarea activa. Cuando esté en pausa, haga clic en Reanudar para reanudar la tarea.
    • Haga clic en Eliminar para eliminar la tarea.
      Nota:

      Eliminar una tarea también elimina su historial de ejecución. Para conservar el historial de una tarea activa, plantéese poner en pausa la tarea para detener futuras ejecuciones.

Al cambiar la propiedad de un notebook, también se cambia la propiedad de las tareas de ese notebook. Las tareas se transfieren al nuevo usuario en un estado inactivo. El nuevo propietario puede habilitar las tareas desde en el panel Tareas del editor de notebooks o desde la pestaña Tareas de la página de detalles del elemento del notebook.