Clean Room notebook task for jobs

Use the Clean Room notebook task to run Databricks notebooks in a Clean Room as part of a workflow.

For more information about using Clean Room notebook tasks to create complex workflows, see [/clean-rooms/clean-room-notebook.md#worfklows].

Before you begin

The principal who runs the task must have the EXECUTE CLEAN ROOM TASK privilege on the Clean Room that the notebook is in.

Configure a Clean Room notebook task

You can add a task to an existing workflow or create a new job that uses the Clean Room notebook task type.

Note

The jobs UI displays options dynamically based on other configured settings.

1. Navigate to the task edit page and select the Clean Room notebook task type:

   For a new job:

   1. Click Workflows in the sidebar and click Create job.
   2. In the Type drop-down menu, select Clean Room notebook.

   For an existing job:

   1. Click Workflows
   2. Select the job and go to the Tasks tab.
   3. Click + Add task and select Clean Room notebook.

2. Select the Clean Room that contains the notebook.

3. Select the Notebook.

4. (Optional) If the notebook run depends on another task being completed, select the task dependencies from the Depends on drop-down menu.

5. (Optional) If the notebook uses dbutils.widgets to pass parameters, configure Parameters as key-value pairs that can be accessed by the notebook. See Configure task parameters.

6. (Optional) Configure a warning and timeout Duration threshold, Notifications, and a Retries policy.

7. Click Save task

8. Review the notebook and confirm that the notebook content is up to date.

   The notebook is displayed in preview mode.

9. Click Continue.