## Extract Databricks Genie Agent lineage

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

> Build lineage from Databricks Genie Agents to the Unity Catalog tables and columns they read.

> **Info: Private Preview**
>
> Databricks Genie Agent 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 Genie Agents** and **Enable Genie Agent 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/llms/platform/submit-request/submit-request/llms.txt).

Once you have [crawled Databricks Genie Agents](https://docs.atlan.com/llms/connectors/databricks/crawl-databricks-genie-agents/llms.txt), Atlan can build lineage connecting each Genie Agent to the Unity Catalog tables and columns it reads.

Genie Agent 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 Genie Agent lineage, make sure you have:

- **Feature access enabled for your tenant**: The **Import Genie Agents** and **Enable Genie Agent Lineage** options stay hidden in the workflow setup until the feature is enabled. [Raise a support request](https://docs.atlan.com/llms/platform/submit-request/submit-request/llms.txt) to request access.
- [Crawled Databricks Genie Agents](https://docs.atlan.com/llms/connectors/databricks/crawl-databricks-genie-agents/llms.txt) at least once—lineage for a Genie space 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`

## Extract lineage

To extract Genie Agent 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 Genie Agent Lineage**.
3. Run the workflow.
4. After the workflow completes, open any **Genie Agent** asset in Atlan and select the **Lineage** tab to view its upstream tables and columns.

## What lineage Atlan builds

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

| Upstream asset | Downstream asset | Source |
|---|---|---|
| Table | Genie Agent | `system.access.table_lineage` |
| View | Genie Agent | `system.access.table_lineage` |
| Column | Genie Agent | `system.access.column_lineage` |

Column lineage terminates at the Genie Agent itself. Databricks reports which source columns a Genie space reads, but not which part of the space consumes them, so Atlan doesn't invent a target column.

Atlan doesn't parse a Genie space's example SQL. All lineage comes from what Unity Catalog recorded.

> **Caution: Genie Agent lineage is best effort**
>
> Unity Catalog records lineage only for queries it observed. A Genie space nobody has queried, or one whose queries Databricks hasn't recorded yet, produces no lineage edges. An absent edge isn't a crawl failure.

## See also

- [Crawl Databricks Genie Agents](https://docs.atlan.com/llms/connectors/databricks/crawl-databricks-genie-agents/llms.txt): Discover and catalog Genie spaces from your Databricks workspace.
- [How Atlan builds lineage for Databricks Genie Agents](https://docs.atlan.com/llms/connectors/databricks/how-databricks-genie-lineage-works/llms.txt): Understand the lineage sources, relationships created, and known limits.
- [Extract lineage and usage from Databricks](https://docs.atlan.com/llms/connectors/databricks/extract-lineage-and-usage-from-databricks/llms.txt): Configure the workflow that builds Databricks lineage.

_Last updated: 16 September 2026._

---

> **AI agent?** Install the Atlan Docs MCP for direct access: https://docs.atlan.com/skills/install-docs-mcp.md