Scheduling a notebook

When your notebook is complete and runs without errors, you can run the notebook in a scheduled job. You can create multiple jobs for the same notebook with different schedules.

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.

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.

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.