Scheduling a notebook

When your notebook is complete and runs without errors, you can run the notebook in a scheduled job.

You can schedule a notebook job if it runs in one of the following runtime environments:

  • All Anaconda-based environments, except for the free default environment
  • All Spark environments

Notebook scheduling is not supported if you run your notebook in an IBM Analytics Engine service.

The notebook kernel is always started in a dedicated runtime which consumes capacity unit hours (CUHs) that are tracked. The runtime is stopped when the job finishes.

Important: The interface to schedule a notebook has changed. Instead of creating one schedule per notebook, you can create multiple jobs for the same notebook with different schedules. If you have old notebook schedules that were not created with the new Jobs user interface, you must create new jobs for these notebooks and delete your old schedules before August 12, 2019. See Updating notebook schedules

To schedule a notebook:

  1. Click the jobs icon from the notebook’s menu bar and select Create a job.
  2. Enter a name, a description and select a version. The most recently saved version of the notebook is used by default. If no version of the notebook exists, you must create a version by clicking the versions icon from the notebook action bar.
  3. Select the runtime. By default, the job uses the same environment definition which is selected for the notebook.
  4. Optional: Add a one-time or repeating schedule for the notebook run. Ensure that you define meaningful date and time ranges. You can’t change the time zone; the schedule uses the time zone setting on your browser.
  5. Create a notebook job and run it immediately, or create a job and run it later. All notebook code cells are run and all output cells are updated.

    The notebook job is listed under Jobs in your project. From here, you can change the schedule settings of a job and pick a different environment definition.

You can view the job details:

  • From an opened notebook by clicking the jobs icon from the notebook’s menu bar and selecting View job details. If more than one job exists for a notebook, select which job details to view.
  • From the Jobs tab of your project by clicking the job.