Skip to main content

​
Overview

Data Lineage is a read-only diagram showing which source columns feed each field of a single entity. Use it to answer “where does this field come from?” without opening every record’s mapping in the editor.
Data Lineage view showing source columns on the left connected to entity fields on the right

​
Opening the Lineage View

1

Open the Entity

Open a pipeline, open a layer (for example Silver), and click an entity.
2

Switch to Data Lineage

In the breadcrumb, click the view menu (it shows Editor by default) and select Data Lineage.
The diagram is rebuilt from the entity’s current mappings each time you open it, so edits made in the editor appear right away. You don’t need to publish first.

​
Reading the Diagram

  • Data Sources (left) groups source columns by table. Each group shows the table name with its source system underneath. Tables used as a record’s primary source and tables joined in as related sources both appear.
  • Target Fields (right) lists the entity’s fields that have at least one mapped source column.
  • Arrows connect each source column to every entity field it feeds. A field built from several columns has several incoming arrows; a column used by several fields has several outgoing arrows.
Use the controls in the corner, or scroll and drag, to zoom and pan.

​
Tracing a Field Back to Its Source

If an entity field has unexpected values, find it under Target Fields and follow its arrows back to the source columns. Check those columns’ data in the source system, then open the record in the Editor to review how the columns are combined.

​
Limitations

  • Lineage covers one entity and one hop: source columns to this entity’s fields. It doesn’t show downstream entities or reports that use the entity.
  • The diagram shows which columns feed a field, not how. Expressions, joins, and filters are visible only in the editor.
  • For fields mapped with an expression, only column names wrapped in backticks (for example `client_id`) are detected. Columns referenced without backticks don’t appear.
  • Fields with no mapped source columns, such as constants, aren’t shown.
  • Data Lineage isn’t available when viewing an entity snapshot.

Data Mapping Editor

Edit the mappings that lineage displays

Mapping Fields

Map source columns to entity fields

Managing Entities

Create and organize entities

Configuring Sources

Set up the primary and related sources shown in lineage