Azure Databricks administration introduction

This article provides an introduction to Azure Databricks administrator privileges and responsibilities.

Required Azure admin permissions

To manage your Azure Databricks service, you need the one of the following Azure admin permissions:

  • A user with the Azure Contributor or Owner, role at the subscription level.
  • A user with a custom role definition which has the following list of permissions:
    • Microsoft.Databricks/workspaces/*
    • Microsoft.Databricks/accessConnectors/*
    • Microsoft.Compute/register/action
    • Microsoft.ManagedIdentity/register/action
    • Microsoft.Storage/register/action
    • Microsoft.Network/register/action

Note

The Microsoft.Compute/register/action, Microsoft.ManagedIdentity/register/action, Microsoft.Storage/register/action, Microsoft.Network/registe/actionr permissions are not required if these providers are already registered in the subscription. See Register resource provider.

Databricks admin types

There are two main levels of admin privileges available on the Azure Databricks platform:

  • Account admins: Manage the Azure Databricks account, including enabling Unity Catalog, user provisioning, and account-level identity management.

  • Workspace admins: Manage workspace identities, access control, settings, and features for individual workspaces in the account.

Additionally, users can be assigned these feature-specific admin roles, which have narrower sets of privileges:

  • Marketplace admins: Manage their account’s Databricks Marketplace provider profile, including creating and managing Marketplace listings.

  • Metastore admins: Manage privileges and ownership for all securable objects within a Unity Catalog metastore, such as who can create catalogs or query a table.

  • Billing admins: View budgets and manage the budget policies across account.

What are account admins?

Account admins have privileges over the entire Azure Databricks account. As an account admin, you can manage account settings, set up user provisioning, create metastores for Unity Catalog enablement, and manage identities across all workspaces in the account.

Account admins can also delegate the account admin and workspace admin roles to any other user.

Establish your first account admin

Note

The account console is not available in Azure Government regions.

To enable the account console and establish your first account admin, you’ll need to engage someone who has the Microsoft Entra ID Global Administrator role. For security purposes, only someone with the Microsoft Entra ID Global Administrator role has permissions to assign the first account admin role. After completing these steps, you can remove the Global Administrator from the Azure Databricks account.

The Global Administrator should use the following instructions:

  1. Sign into your Azure Portal with your Global Admin credentials.
  2. Go to accounts.azuredatabricks.net and sign in with Microsoft Entra ID. Azure Databricks automatically creates an account admin role for you.
  3. Click User management.
  4. Find and click the username of the user you want to delegate the account admin role to.
  5. On the Roles tab, turn on Account admin.

Once another user has the account admin role, the Microsoft Entra ID Global Administrator no longer needs to be involved. The new account admin can remove the Global Administrator from the Azure Databricks account and assign other users the account admin role.

Access the account console

The account console is where account admins manage their Azure Databricks account.

Default account console view

Account admins can access the account console at https://accounts.azuredatabricks.net or by clicking the workspace selector at the top of the workspace UI and selecting Manage account.

Account users who are not account admins can only access the account from https://accounts.azuredatabricks.net. Upon logging in, the account console opens to a list of their workspaces.

Note

If you are in multiple Microsoft Entra ID tenants, the account console URL will bring you to the Azure Databricks account console in your default tenant. To access the account console of a different tenant, access the account console from within a workspace in your preferred tenant.

Account admin responsibilities

As an account admin, your responsibilities include:

Enable Unity Catalog

Note

If your Azure Databricks account was created after November 9, 2023, your workspaces might have Unity Catalog enabled by default. For more information, see Automatic enablement of Unity Catalog.

An account admin is needed to enable Unity Catalog in your account. The process involves creating a Unity Catalog metastore, which can only be done by an account admin.

For instructions on enabling Unity Catalog, see Get started using Unity Catalog.

Manage identities

Account admins should sync their identity provider with Azure Databricks if applicable. See Sync users and groups from Microsoft Entra ID.

If you’ve enabled Unity Catalog for at least one workspace in your account, identities (users, groups, and service principals) should be managed in the account console. Account admins can grant permissions and assign workspaces to these identities.

For more information, see Manage users and groups.

Monitor account with system tables

System tables are an Azure Databricks-hosted analytical store of your account’s operational data found in the system catalog. Account admins can enable system tables to access audit logs, billable usage logs, lineage data, and more. See Monitor account activity with system tables.

Manage account settings

Account admins can manage aspects of their Azure Databricks account from the account console using the Settings section. This includes enabling new features across the account and configuring IP access lists.

Manage Previews

Manage Azure Databricks Previews in your workspace or an organization’s workspaces. Previews provide early access to features before they are released for general availability (GA). See Manage Azure Databricks Previews.

What are workspace admins?

Workspace admins have admin privileges within a single workspace. They can manage workspace-level identities, regulate compute use, and enable and delegate role-based access control (Premium plan only).

Access the admin settings

Workspace admins are the only users who have access to the workspace’s admin settings page. As a workspace admin, you can access admin settings by clicking your username in the top bar of the Azure Databricks workspace and selecting Settings.

Default admin settings view

Workspace admin responsibilities

As a workspace admin, your responsibilities include:

Manage identities in your workspace

If your workspace is enabled for Unity Catalog, identities should be added at the account level. Workspace admins can then assign users, groups, and service principals to their workspace. For more information on adding and removing identities in a workspace, see Manage users, service principals, and groups.

Note

Databricks Academy has a free course on Identity Administration. Before you can access the course, you first need to register for Databricks Academy if you haven’t already.

Create and manage compute resources

Workspace admins can create SQL warehouses (a compute resource that lets you run SQL commands on data objects within Databricks SQL) and clusters for their workspace users. For instructions on creating SQL warehouses, see Create a SQL warehouse.

It is also the workspace admin’s job to regulate how compute resources are used in their workspace. Workspace admins have the following tools:

  • Limit workspace users’ cluster creation options with cluster policies.
    • Databricks recommends managing all init scripts as cluster-scoped init scripts. Instead of using global init scripts, manage init scipts using cluster policies.
  • Learn which compute resources have Unity Catalog access.

Note

Databricks Academy has a free course on Compute Resources Administration.

Manage workspaces features and settings

Workspace admins are responsible for managing select workspace behavior and settings. For information on other available workspace settings, see Managing workspace settings.

Additional resources

Databricks Academy has a free self-paced learning path for platform administrators. Before you can access the course, you first need to register for Databricks Academy if you haven’t already.

You can also sign up to attend a live platform administration training.