Skip to main content

Azure manual workspace creation

You'll create a Databricks workspace on Azure in ~10 min.

Prereqs: Azure subscription, Databricks account console

What you'll walk away with​

A running Databricks workspace in your Azure subscription, created from the Azure portal. The portal sets up the managed resource group, the VNet resources, and the workspace configuration for you.

Prerequisites​

  • An Azure subscription with Contributor on the target resource group.
  • A Databricks account with account-admin privileges.
  • The subscription and resource group the workspace belongs to (for example, the dev workspace on the dev subscription).

Steps​

1. Create the development workspace​

Follow the video below. As you deploy:

  • Pick the right subscription and resource group for the environment.
  • For example, put the dev workspace in the dev subscription and dev Databricks resource group.
warning

Match the subscription and resource group to the environment. A dev workspace dropped into a production subscription is hard to untangle later.

2. Repeat for staging and production​

Run the same process for each additional workspace, picking the matching subscription and resource group each time.

Verify​

  1. Log in to the Databricks account console.
  2. Open Workspaces and confirm the new workspace shows Running.
  3. Click the workspace URL and confirm the landing page loads.

Where people trip​

Workspace deployment fails in the Azure portal

Check the Azure Activity Log for the resource group. Common causes: insufficient permissions on the subscription, the Microsoft.Databricks resource provider not registered, or a quota limit in the target region.

Cannot access the workspace after creation

Confirm your user account was added to the workspace. If you use Entra ID (Azure AD), check that the user exists in the linked directory and is assigned to the Databricks enterprise application.

Next​