## Extract Databricks dashboard lineage

URL: https://docs.atlan.com/apps/connectors/data-warehouses/databricks/how-tos/extract-databricks-dashboard-lineage

> Build lineage from Databricks AI/BI dashboards to the Unity Catalog tables, columns, and metric views they read, and populate dashboard usage metrics.

:::info Private Preview
Databricks AI/BI dashboard support is in [private preview](https://docs.atlan.com/llms/platform/get-started/product-release-stages/llms.txt) and is enabled per tenant. The **Import AI/BI Dashboards** and **Enable Dashboard Lineage** options stay hidden in the workflow setup until the feature is enabled for your tenant. To request access, [raise a support request](https://docs.atlan.com/support/submit-request).
:::

Once you have [crawled Databricks AI/BI dashboards](https://docs.atlan.com/llms/connectors/databricks/crawl-databricks-ai-bi-dashboards/llms.txt), Atlan can build lineage connecting each dashboard to the Unity Catalog tables, columns, and metric views it reads. The same workflow populates usage and popularity metrics for your dashboards.

Dashboard lineage runs in the Databricks lineage and usage workflow—the same workflow that builds table and column lineage—not in the crawler.

## Prerequisites

Before extracting dashboard lineage, make sure you have:

- **Feature access enabled for your tenant**: The **Import AI/BI Dashboards** and **Enable Dashboard Lineage** options stay hidden in the workflow setup until the feature is enabled. [Raise a support request](https://docs.atlan.com/support/submit-request) to request access.
- [Crawled Databricks AI/BI dashboards](https://docs.atlan.com/llms/connectors/databricks/crawl-databricks-ai-bi-dashboards/llms.txt) at least once—lineage for a dashboard Atlan hasn't cataloged produces no edges
- [Set up lineage and usage extraction](https://docs.atlan.com/llms/connectors/databricks/extract-lineage-and-usage-from-databricks/llms.txt) for the same connection
- `SELECT` on `system.access.table_lineage` and `system.access.column_lineage`, and on `system.query.history` for usage metrics

## Extract lineage

To extract dashboard lineage:

1. Follow the standard [Extract lineage and usage from Databricks](https://docs.atlan.com/llms/connectors/databricks/extract-lineage-and-usage-from-databricks/llms.txt) steps.
2. Under lineage extraction, turn on **Enable Dashboard Lineage**.
3. Run the workflow.
4. After the workflow completes, open any **Dashboard** asset in Atlan and select the **Lineage** tab to view its upstream tables, columns, and metric views.

## What lineage Atlan builds

Atlan reads dashboard lineage from the Unity Catalog lineage system tables and creates these relationships:

| Upstream asset | Downstream asset | Source |
|---|---|---|
| Table | Dashboard | `system.access.table_lineage` |
| Metric view | Dashboard | `system.access.table_lineage` |
| Column | Dashboard | `system.access.column_lineage` |

Column lineage terminates at the dashboard itself. Databricks reports which source columns a dashboard reads, but not which dashboard element consumes them, so Atlan doesn't invent a target column.

## Dashboard usage metrics

When usage extraction is turned on, the same workflow populates these metrics on each dashboard from Databricks query history:

| Metric | Description |
|---|---|
| Source read count | Number of queries run against the dashboard in the lookback window |
| Source read user count | Number of distinct users who ran those queries |
| Source last read at | Timestamp of the most recent query |
| Popularity score | Derived from the read count and distinct user count |

Usage metrics cover the lookback window you configure for usage extraction, not the dashboard's entire history.

## See also

- [Crawl Databricks AI/BI dashboards](https://docs.atlan.com/llms/connectors/databricks/crawl-databricks-ai-bi-dashboards/llms.txt): Discover and catalog AI/BI dashboards from your Databricks workspace.
- [How Atlan builds lineage for Databricks dashboards](https://docs.atlan.com/llms/connectors/databricks/how-databricks-dashboard-lineage-works/llms.txt): Understand the lineage sources, relationships created, and known limits.
- [Permissions for Databricks AI/BI dashboards](https://docs.atlan.com/llms/connectors/databricks/permissions-for-databricks-ai-bi-dashboards/llms.txt): Full reference of the privileges required to crawl dashboards and extract their lineage.

---