Cluster access control

Note

Access control is available only in the Azure Databricks Premium Plan.

By default, all users can create and modify clusters unless an administrator enables cluster access control. With cluster access control, permissions determine a user’s abilities. This article describes the permissions.

Before you can use cluster access control, an Azure Databricks admin must enable it for the workspace. See Enable cluster access control for your workspace.

Types of permissions

You can configure two types of cluster permissions:

  • The Allow Cluster Creation permission controls your ability to create clusters.
  • Cluster-level permissions control your ability to use and modify a specific cluster.

When cluster access control is enabled:

  • An administrator can configure whether a user can create clusters.
  • Any user with Can Manage permission for a cluster can configure whether a user can attach to, restart, resize, and manage that cluster.

Cluster-level permissions

There are four permission levels for a cluster: No Permissions, Can Attach To, Can Restart, and Can Manage. The table lists the abilities for each permission.

Ability No Permissions Can Attach To Can Restart Can Manage
Attach notebook to cluster x x x
View Spark UI x x x
View cluster metrics x x x
Terminate cluster x x
Start cluster x x
Restart cluster x x
Edit cluster x
Attach library to cluster x
Resize cluster x
Modify permissions x

Note

You have Can Manage permission for any cluster that you create.

Configure cluster-level permissions

Note

This section describes how to manage permissions using the UI. You can also use the Permissions API.

Cluster access control must be enabled and you must have Can Manage permission for the cluster.

  1. Click the clusters icon Clusters Icon in the sidebar.

  2. Click the Permissions Icon icon under the Actions column of an existing cluster.

    ClusterACLsButton

  3. In the Permission settings for dialog, you can:

    • Select users and groups from the Add Users and Groups drop-down and assign permission levels for them.
    • Update cluster permissions for users and groups that have already been added, using the drop-down menu beside a user or group name.

    IndvClusterACLs

  4. Click Done.

Example: using cluster-level permissions to enforce cluster configurations

One benefit of cluster access control is the ability to enforce cluster configurations so that users cannot change them.

For example, configurations that admins might want to enforce include:

  • Tags to charge back costs
  • Azure AD credential passthrough to Azure Data Lake Storage to control access to data
  • Standard libraries

Azure Databricks recommends the following workflow for organizations that need to lock down cluster configurations:

  1. Disable Allow cluster creation for all users.

    Cluster creation checkbox

  2. After you create all of the cluster configurations that you want your users to use, give the users who need access to a given cluster Can Restart permission. This allows a user to freely start and stop the cluster without having to set up all of the configurations manually.

    Can restart