Navigate the Lakehouse workspace UI

Learn how to navigate the Lakehouse workspace UI and find the features you need. This article explains the core concepts of the Azure Databricks workspace UI, an environment for authoring and accessing all of your Azure Databricks objects.

You can manage workspace assets and settings 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 Lakehouse 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 Databricks:

Ask Genie

Ask Genie is the first section on the workspace homepage. It gives you quick access to three modes:

  • Ask: Ask data questions in natural language. Genie routes your question to the most relevant Genie Space.
  • Search: Search for workspace objects such as dashboards, notebooks, and queries.
  • Genie Code: Start a Genie Code conversation to author dashboards and analyze data using natural language.

Ask Genie on the workspace homepage.

Suggested

This section displays workspace objects recommended based on your activity.

Favorited

This section displays objects you have marked as favorites.

Popular

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

Mosaic AI

This section provides quick access to AI-related assets and features.

What's new

This section highlights recently released features and updates in Azure Databricks.

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

  • Notebook icon. Workspace
  • Clock icon. Recents
  • Data icon. Catalog
  • Workflows icon. Jobs & Pipelines
  • Cloud icon. Compute
  • Storefront icon. Marketplace

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

  • Query editor icon. SQL Editor
  • Query icon. Queries
  • Dashboard icon. Dashboards
  • Sparkle rectangle icon. Genie Spaces
  • Notification icon. Alerts
  • History icon. Query History
  • Cloud database icon. SQL Warehouses

Data Engineering

  • Checklist icon. Job Runs
  • Ingestion icon. Data Ingestion

AI/ML

  • AI Playground icon. Playground
  • Agents icon. Agents
  • Beaker icon. Experiments
  • Layer icon. Features
  • Models icon. Models
  • Cloud model icon. Serving

+ New menu

Click + New to complete the following tasks:

  • Create workspace objects such as notebooks, queries, repos, dashboards, alerts, jobs, pipelines, 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.

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. For more information about search features, see Search for workspace objects.

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 Settings.

All workspace user settings are now accessed from Settings.

  • The Password setting is on the Profile tab.
  • SQL query snippets (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.

Switch between authoring contexts

In the notebook, file, SQL, and pipeline editors, click the icon in the upper-left (either Home icon., Query editor icon., or Pipeline icon.) to switch between tab groups based on the following authoring contexts:

  • Home icon. Workspace: Switch to the default workspace tab group, which shows open tabs for notebooks and files. These tabs are ephemeral and might not be saved if you exit your browser.
  • History icon. Recent workspace tabs: View past workspace tab sessions and restore them.
  • Query editor icon. SQL Editor: Switch to the SQL editor for your SQL queries. These tabs are persistent and remain open even after you exit your browser.
  • Pipeline icon. Pipeline: Switch to the pipeline. Each pipeline has its own distinct authoring context. When you switch to a pipeline, you’ll see a persistent set of tabs specific to that pipeline.

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 Settings and go to the Preferences tab.

Get help

This section describes the in-product help experience.

Click Help Icon in the top bar of the workspace to access the in-product help experience (Public Preview). In-product help provides the following resources:

  • Send Feedback: Use the feedback form to submit product feedback from your workspace. See Submit product feedback.

  • Help Center: Search across Azure Databricks documentation, Azure Databricks Knowledge Base articles, Apache Spark documentation, training courses, and Azure Databricks forums, or submit a help ticket.

  • If an account admin has completed the following steps to enable third-party services for AI assistive features, you can enter a question in the text box for the AI chatbot.

    1. As an account admin, log in to the account console.
    2. Click Settings Settings icon.
    3. Click the Features tab.
    4. Toggle Enable Azure AI services-powered features to Enable for all.

    The AI chatbot is intended to help quickly answer questions that can be answered with Databricks documentation and knowledge bases. Its answers are based on documentation that the AI can find related to the question. If it cannot find documentation related to the user question, it declines to answer. Results include a link to any documentation used to answer the question. The AI is new so mistakes are possible. Make sure to check the facts with the linked documentation, and share feedback.

Managing files and folders

For detailed information about managing files and folders in the workspace browser, see Workspace browser and file management.

  • Last updated on