Tutorial: Use sample dashboards in Databricks SQL

This tutorial shows you how to import and use sample dashboards from the Databricks SQL Dashboard Samples Gallery. These dashboards illustrate some of the rich visualizations that Databricks SQL provides for gaining insights from your data. No setup is required. These dashboards use data that is already available to your workspace and rely on a compute resource (called a SQL warehouse) that is already configured. You don’t need to be an administrator to get started.

Requirements

  • The user who performs these steps must have the Databricks SQL access entitlement.

    All users in new workspaces have this entitlement. To grant a user this entitlement, a workspace admin can go to the admin settings page and grant the Databricks SQL access entitlement to a user.

    WARNING: The Dashboard sample gallery has been configured to use a Starter Warehouse delivered with your installation. The SQL warehouse won’t start if you do not provision the required amount of CPU and storage resources. If resources are insufficient, ask the administrator to increase the quota. See Compute Engine API. For information about workspace cost, see cost per workspace.

Import a dashboard

  1. In the sidebar, click Dashboards Icon Dashboards

    If your workspace has any saved dashboards, they are listed.

  2. Click on View samples gallery.

    Note

    You can also navigate to the Dashboard Samples Gallery by appending /sql/dashboards/samples/ to your workspace URL.

  3. In the Retail Revenue & Supply Chain tile, click Import. The dashboard is imported into your workspace, and you are the owner.

    The imported dashboard appears, and its visualizations are refreshed.

    Imported Retail Revenue & Supply Chain dashboard

You can import a sample dashboard multiple times, and multiple users can each import it. You can also import the NYC Taxi Trip Analysis dashboard.

Explore a visualization’s query

  1. Each visualization in a dashboard is the result of a query. In the imported dashboard, hover over the National Revenue Trends visualization, then click the Vertical Ellipsis context menu. Click View Query.

    National Revenue Trends context menu

    The SQL editor appears with the visualization’s query displayed.

    National Revenue Trends query

    The sample dashboards use data in the SAMPLES catalog, which is separate from data within your workspace. The SAMPLES catalog is available to every workspace, but is read-only.

  2. At the bottom of the query, change LIMIT 1000 to LIMIT 500 to return only 500 records. Click Run All to run the modified query, then click Save to save the query in the dashboard.

    Note

    When you modify the imported dashboard, the original dashboard in the Dashboard Samples Gallery is not modified. To start over, you can re-import the dashboard.

  3. Click the browser’s Back button to go back to the dashboard.

Interact with a visualization

  1. Hover over the Shifts in Pricing Priorities visualization. At the bottom, click the Expand Icon at the right to expand the visualization.

  2. Use the buttons at the top right of the visualization to explore the data. You can download, zoom, pan, or autoscale the visualization.

    Expanded Shifts in Pricing Priorities visualization
  3. Click Close to go back to the dashboard.

Share the dashboard

To share a dashboard with colleagues:

  1. Click Share at the top of the page.

  2. Select a user or group in your workspace.

    To share the dashboard with all users in the workspace, select All users.

  3. Select the permission to grant.

    Share dashboard permissions

    By default, all six queries in the dashboard are shared.

    Note

    You cannot share an object with Can edit if it has credentials set to Run as owner.

  4. At the bottom of the sharing form, select whether the dashboard runs using the viewer’s credential or the owner’s credential.

  5. Click Add, then close the form.

Schedule automatic dashboard refreshes

You can schedule the dashboard to automatically refresh at an interval.

  1. At the top of the page, click Schedule.

  2. Click Add schedule.

  3. Select an interval, such as Every 1 hour at 5 minutes past the hour.

  4. Click More options to modify the default schedule name and to specify a SQL warehouse. A SQL warehouse is a compute resource that is specific to Databricks SQL. The SQL warehouse runs the dashboard’s queries and generates the visualizations when the dashboard is refreshed.

    Workspace admin users can create, configure, and delete SQL warehouses.

  5. Optionally, on the Subscribers tab, you can choose to send a dashboard snapshot to subscribers when it is refreshed.

    Workspace admin users can create, configure, and delete notification destinations. The email addresses of workspace users are automatically added as notification destinations.

  6. Click Create schedule.

    The dashboard will be refreshed according to the schedule.

  7. To delete an existing refresh schedule for a dashboard:

    1. Click Schedule (1).

    2. Click the kebab menu Vertical Ellipsis on the right.

    3. Click Delete and then click Delete to confirm.