Skip to content
METRIC OAK

New: the 3-week Data Platform Assessment: fixed fee, priced roadmap. See what's included →

Explainer

What is data lineage? Why it matters and how to capture it

Data lineage records where data comes from and everything that transforms it on the way to reports and models. Table and column lineage, how it is captured, tools, and its uses: impact analysis, root-cause analysis and regulation.

Hemant Walchale

Hemant Walchale
· 3 min read

Data lineage records where data comes from and every step that transforms it on its way to reports, dashboards and models. It answers two questions every data team is asked: where did this number come from? and what breaks if we change this?

Data lineage graph: CRM, billing database and product events source systems feed silver tables customers_clean and invoices_clean, which feed the gold table revenue_by_customer, which feeds a board revenue report and a churn model. Tracing upstream answers where a revenue number comes from; tracing downstream from the billing database shows every table, report and model a change would break.

Upstream and downstream

  • Upstream lineage traces a figure back to its sources: which tables, columns and transformations produced this revenue number?
  • Downstream lineage shows the impact of a change: if the billing system renames a column, which tables, dashboards and models are affected?

Table-level and column-level

  • Table-level lineage shows which tables feed which. Useful for orientation and impact at a glance.
  • Column-level lineage shows which source columns feed each column, through which transformations. Needed to trace a single metric, or to find every place a sensitive field such as a national ID is used.

What lineage is used for

  1. Impact analysis: check what a schema change, migration or deprecation will break before making it.
  2. Root-cause analysis: when a dashboard is wrong, follow the lineage upstream to the failing step.
  3. Regulation and audit: show how reported figures are produced, for example under BCBS 239 for banks, and where personal data flows under privacy law.
  4. Migrations: find every consumer of a legacy table before switching it off.
  5. Trust and discovery: let analysts see whether a table comes from trusted, tested sources.

How it is captured

Hand-drawn lineage goes stale within weeks. Modern lineage is captured automatically:

  • From the platform: Unity Catalog on Databricks records table and column lineage for queries and jobs it runs; Snowflake and Microsoft Purview provide lineage for their ecosystems.
  • From transformation code: dbt builds a lineage graph from model dependencies.
  • From orchestration: the OpenLineage open standard lets orchestrators and engines (such as Airflow and Spark) send lineage events to a shared store.

Gaps usually appear at the edges, in spreadsheets, scripts on servers and SaaS tools, so combine automatic capture with ownership and documentation for those.

The short version

Data lineage maps where data comes from and what it feeds, at table and column level. Capture it automatically from your platform, transformation tools and orchestrator, and use it for impact analysis, root-cause analysis, regulation and migrations.

Related: what is Unity Catalog, data contracts for data leaders, medallion architecture and our data quality and governance service.

Sources

Not sure where your own platform stands? Take the free 3-minute data platform scorecard. Unfamiliar terms are explained in the data engineering glossary.

Frequently asked questions

What is data lineage in simple terms?

Data lineage is a map of where data comes from and every step that changes it on its way to a report, dashboard or model. It answers two questions: where did this number come from, and what will break if this source changes?

What is the difference between table-level and column-level lineage?

Table-level lineage shows which tables feed which. Column-level lineage shows which source columns feed each column, through which transformations. Column-level lineage is what you need to trace a single metric or find every use of a sensitive field.

How is data lineage captured?

Mostly automatically: platforms record lineage from the queries and jobs they run (for example Unity Catalog on Databricks, Snowflake's lineage features and Microsoft Purview), tools like dbt build it from model code, and the OpenLineage standard lets orchestrators and engines report lineage to a common store.

Why do regulators care about data lineage?

Regulations and supervisory principles for risk and financial reporting, such as BCBS 239 for banks, expect firms to show how reported figures are produced from source data. Lineage is the evidence.

Have 30 minutes? Get a senior architect’s view of your data platform.

No sales deck. You talk to the engineer who would lead the work.

Book an architecture review