Tutorial: Use sample dashboards

This tutorial shows you how to import and use sample dashboards from the samples gallery. These dashboards illustrate some of the rich visualizations you can use to gain insights from your data. No setup is required. These dashboards use data already available in your workspace and rely on a compute resource (called a SQL warehouse) already configured. You don’t need to be an administrator to get started.

A published dashboard from the samples gallery

See Dashboards to learn about all of the visualization types and features available for dashboards.

Import a dashboard

  1. In the sidebar, click Dashboards Icon Dashboards

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

  2. Click View samples gallery.

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

The imported draft dashboard appears, and its visualizations are refreshed.

Draft 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. You can access all queries in the Data tab on the draft dashboard. Click Data in the upper-left corner of the screen. Then, click the dataset you want to view to see the associated query.

Dashboard data tab with queries

The SQL editor includes the query and results, which are shown in a table below the query.

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

  1. Click the Canvas tab to go back to the canvas that shows the dashboard’s visualization widgets.

Interact with a visualization

  1. Hover over the Revenue by Order Priority visualization.

  2. Click each Priority in the legend to focus on that group of data and hide the other lines.

  3. Right-click on the visualization to see its context menu. You can delete or clone a visualization. You can also download the associated dataset as a CSV, TSV, or Excel file. Click Go to Revenue by Order Priority to view the associated query.

Revenue by Order Priority visualization and context menu

The query opens on the Data tab of your dashboard.

Publish the dashboard

  • Click Publish at the top of the page. A Publish dialog appears.

  • Click Publish in the dialog to create a sharable, non-editable version of your dashboard. This dashboard is published with your credentials embedded by default. This means that other viewers use your credentials to access the data and compute to generate visualizations on your dashboard. See Publish a dashboard.

  • Use the switcher at the top of the page to view your published dashboard.

Drop-down menu showing available draft and published dashboard versions.

Share the dashboard

To share a dashboard with colleagues in your workspace:

  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 workspace users. Then, click Add.

  3. Select the permission to grant.

    Share dashboard permissions

To share a dashboard with account users:

  1. Under Sharing settings at the bottom of the sharing dialog, click Anyone in my organization can view.

    This means that anyone who is registered to your Databricks account can use a link to access your dashboard. If you have embedded your credentials, account-level users don’t need workspace access to view your dashboard.

  2. Close the form.

Schedule automatic dashboard refreshes

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

  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. The SQL warehouse that you selected to run your queries is used to run the dashboard’s queries and generate visualizations when the dashboard is refreshed.

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

  4. Click Create.

    The dialog shows all schedules associated with the dashboard.

  5. Optionally, click Subscribe to add yourself as a subscriber and receive an email with a PDF snapshot of the dashboard after a scheduled run completes.

    You can use the kebab menu Kebab menu to edit the schedule and add more subscribers. See Schedule dashboards for periodic updates.

  6. To delete an existing schedule for a dashboard:

    1. Click Subscribe.

    2. Click the kebab menu Kebab menu on the right.

    3. Click Delete.