Work with Databricks clean rooms as an invited collaborator

Preview

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

This article describes how to join and work in a Databricks clean room as an invited collaborator.

Databricks Clean Rooms provides a secure and privacy-protecting environment where multiple parties can work together on sensitive enterprise data without direct access to each other’s data. For more information, see What is Databricks Clean Rooms?.

When another collaborator creates a clean room so that you can work with them on a shared data project, there are two tasks that someone in your organization must perform:

  1. Find and send the clean room creator your Unity Catalog metastore’s sharing identifier.

  2. When the clean room appears in your Unity Catalog metastore, grant users in your organization access to it.

This article describes those tasks, along with instructions for managing and working in a clean room.

Find your sharing identifier

When a collaborator creates a clean room that they want to share with you, they will request your sharing identifier. The sharing identifier is a string that consists of your metastore’s cloud, region, and UUID (the unique identifier for the metastore), in the format <cloud>:<region>:<uuid>.

Permissions required: To get the sharing identifier, you must have the BROWSE privilege on your metastore, have any privilege on any clean room, have the CREATE CLEAN ROOM privilege, or be a metastore admin.

To get the sharing identifier:

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

  2. On the Quick access page, click the Clean Rooms > button.

    Alternatively, click the Gear icon gear icon at the top of the Catalog pane and select Clean Rooms.

  3. On the Clean Rooms page, click your organization name and select Copy sharing identifier from the menu.

    Get the sharing identifier
  4. Send the sharing identifier to the clean room creator.

View, edit, grant access to, monitor, and delete a clean room

To learn how to view, edit, grant access to, monitor audit logs for, and delete a clean room, see Manage clean rooms.

Add data assets and notebooks to a clean room that was shared with you

To learn how to add tables, volumes, and notebooks to a clean room, see Step 3. Add data assets and notebooks to the clean room. The process is the same, whether you are the clean room creator or an invited collaborator.

Run notebooks in a clean room

To learn how to run notebooks in a clean room, see Run notebooks in clean rooms. You can run notebooks that were added to the clean room by the other collaborators, but you cannot run notebooks that you add to the clean room yourself.