Run notebooks in clean rooms

Preview

This feature is in Public Preview. To request access, reach out to your Databricks representative.

This article describes how to run notebooks in clean rooms. Notebooks are the interface that collaborators use to run data analysis in collaboration.

To learn how to add a notebook to a clean room, see Create clean rooms.

Before you begin

To run a notebook in a clean room, you must be:

  • The owner of the clean room or have the EXECUTE CLEAN ROOM TASK privilege on the clean room.

  • A collaborator who did not create the notebook. The notebook creator cannot run the notebook. This enforces implicit approval of the notebook by both parties.

Note

The creator is automatically assigned as the owner of the clean room in their Databricks account. The collaborator organization’s metastore admin is automatically assigned ownership of the clean room in their Databricks account. You can transfer ownership. See Manage Unity Catalog object ownership.

Run a notebook in a clean room

To run a notebook in a clean room, you must use Catalog Explorer.

  1. In your Databricks workspace, click Catalog icon Catalog.

  2. At the top of the Catalog pane, click the Gear icon gear icon and select Clean Rooms.

    Alternatively, from the Quick access page, click the Clean Rooms > button.

  3. Select the clean room from the list.

  4. Under Notebooks, click the notebook to open it in preview mode.

  5. Click the Run button.

    You can only run notebooks that the other collaborator has shared.

  6. (Optional) On the Run notebook with parameters dialog, click **+ Add++ to pass parameter values to the notebook job task.

    For more information about parameters for job tasks, see Pass parameters to a Databricks job task.

  7. Click the confirmation checkbox.

  8. Click Run.

  9. Click See details to view the progress of the run.

    Alternatively, you can view run progress by going to Runs on this page or by clicking Workflows in the workspace sidebar and going to the Job runs tab.

  10. View the results of the notebook run.

    The notebook results appear after the run is complete. To view past runs, go to Runs and click the link in the Start time column.