Navigate the workspace

  • Article

This article walks you through the Azure Databricks workspace UI, an environment for accessing all of your Azure Databricks objects.

You can manage the workspace using the workspace UI, the Databricks CLI, and the Workspace API. Most of the articles in the Azure Databricks documentation focus on performing tasks using the workspace UI.

Homepage

The following sections of the workspace homepage provide shortcuts to common tasks and workspace objects to help you onboard to and navigate the Azure Databricks Lakehouse:

Get started

This section provides shortcuts to the following common tasks across product areas:

  • Import data using the Create or modify table from file upload page
  • Create a notebook
  • Create a query
  • Configure an AutoML experiment

Note

The tiles that display on your homepage depend on your assigned entitlements.

Recents

This section displays your recently viewed workspace objects across product areas, including files, notebooks, experiments, queries, dashboards, and alerts.

You can also access recents from the sidebar and from the search bar.

Popular

This section displays objects with the most user interactions in the last 30 days across product areas, including files, notebooks, experiments, queries, dashboards, and alerts.

The following common Azure Databricks Lakehouse categories are visible at the top of the sidebar:

  • Workspace
  • Recents
  • Data
  • Workflows
  • Compute

New navigation sidebar

Note

There is a lock icon next to items that require an entitlement you aren’t assigned.

The features in the following sections are also always visible in the sidebar, grouped by product area:

SQL

  • SQL Editor
  • Queries
  • Dashboards
  • Alerts
  • Query History
  • SQL Warehouses

Previous UI

Old navigation sidebar SQL persona

New UI

New navigation sidebar SQL task group

Data Engineering

  • Delta Live Tables

Previous UI

Old navigation sidebar Data Science and Engineering persona

New UI

New navigation sidebar Data Engineering task group

Machine Learning

  • Experiments
  • Feature Store
  • Models
  • Serving

Previous UI

Old navigation sidebar ML persona

New UI

New navigation sidebar ML task group

+ New menu

Click + New to complete the following tasks:

  • Create workspace objects such as notebooks, queries, repos, dashboards, alerts, jobs, experiments, models, and serving endpoints
  • Create compute resources such as clusters, SQL warehouses, and ML endpoints
  • Upload CSV or TSV files to Delta Lake using the Create or modify table from file upload page or load data from various data sources using the add data UI

Previous UI

Old navigation create menu

New UI

New navigation create menu

Full-page workspace browser

The full-page workspace browser experience unifies Workspace and Repos.

Unified filebrowser in sidebar

You can browse content in Databricks Repos alongside workspace objects by clicking Workspace in the sidebar.

Unified filebrowser with workspace objects Repos content

You can also browse workspace content and Repos content from within a notebook using a contextual browser.

Notebook contextual browser

Use the top bar to search for workspace objects such as notebooks, queries, dashboards, alerts, files, folders, libraries, tables registered in Unity Catalog, jobs, and repos in a single place. You can also access recently viewed objects in the search bar.

Workspace admin and user settings

Workspace admin and workspace user settings are unified across product areas. SQL settings are combined with general settings to create a unified experience for admin and non-admin users.

All workspace admin settings are now accessed from Admin Settings, including the following tabs:

  • SQL settings
  • External data sources
  • SQL warehouse settings

All workspace user settings are now accessed from User Settings, including the following tabs:

  • The Password setting is on the Profile tab.
  • SQL query snippets (User settings > Developer) is visible to users with the Databricks SQL access entitlement.

Switch to a different workspace

If you have access to more than one workspace in the same account, you can quickly switch among them.

  1. Click the workspace name in the top bar of the Azure Databricks workspace.
  2. Select a workspace from the drop down to switch to it.

Change the workspace language settings

The workspace is available in multiple languages. To change the workspace language, click your username in the top navigation bar, select User Settings and go to the Preferences tab.

Get help

To get help:

  1. Click Help icon in the top bar of the Azure Databricks workspace.
  2. Select one of the following options:
    • Learn Databricks: Follow the in-product onboarding experience.
    • Help Center: Submit a help ticket or search across Azure Databricks documentation, Azure Databricks Knowledge Base articles, Apache Spark documentation, and Azure Databricks forums.
    • Release Notes: View Azure Databricks Release notes.
    • Documentation: View Azure Databricks documentation.
    • Knowledge Base: View Azure Databricks Knowledge Base.
    • Databricks Status: View Azure Databricks status by region.
    • Privacy Policy: View Microsoft privacy statement.
    • Send feedback: Provide Databricks product feedback.