Skip to main content Skip to complementary content

Lineage Diagram

The data flow "interactive" Diagram displays the columns/fields involved in the given data flow trace, not all the columns. The user can then select the columns/fields to be displayed to better present the business use case of that data flow. Then the user can interact within that diagram by selecting columns/fields to display its lineage. Furthermore, the Diagram allows you to display conditional labels such as PII or Confidential SensitivityLevel, not only providing more critical information to the user, but also better visualization of the propagation of that information (e.g. PII) through the data flow lineage trace.

Information note

Please refer to the Lineage Diagram visualization common features.

In order to see data flow lineage, one must

Once the configuration is ready, then you are ready to report on lineage.

Information note

End-to-end data flow lineage across models is only available at the classifier (e.g., table) and feature (e.g., column) level. If instead, one goes to the object page for a schema or model, , as this is not classifier or feature, the lineage tab shows the overview lineage within the scope of that model only.

Steps

  1. Trace data flow lineage.
  2. Click the Analysis Diagram tab on the left side.
  3. From here you may
    • Pick the Direction in the pull-down in the header of the diagram:
      • Impact (Destination) direction
      • Lineage (Sources) direction
      • Any type for both data impact and lineage.
    • Select which columns to display in the diagram using the Columns pull-down in the header of the diagram.
      • A list of possible columns with a quick find is presented with checkboxes.
    • Pick the Depth in the pull-down in the upper right.
      • 1 (Adjacent) step in the lineage. Objects in the lineage that are the next items in a lineage trace.
Information note

For impact, adjacent can often be the data store (like a warehouse) that is the target of an object being loaded by DI/ETL that is the focus of the lineage. For course lineage, it can often mean the data source directly loaded from to produce the object that is the focus of the lineage.

Example

Navigate to the object page for the Customer table in the Staging DW.dbo schema.

Go to the Lineage tab and click the Diagram tab on the left side.

Pick ANY for the Direction in the pull-down in the diagram header.

Information note

The red colored pin indicating the source of the lineage and impact trace.

The diagram defaults to the classifier (table) level for performance reasons.

Click the Show actions for the selected object icon and select Show Columns.

Information note

Now columns are visible, but still not the column lines. Again, this is for reasons of performance and simplicity of presentation.

Click on the Display Options icon and click Show Conditional Labels

Here, you may pick and choose conditional labels to show in the diagram and the image shows all of them selected for display.

Click on the Display Options icon and select Show Term Definitions

Information note

Terms, like US Social Security Number (documenting the ID field), are used to document columns and tables that are in this lineage trace and this is shown in the diagram.

Lineage Diagram Visualization Common Features

There are a number of common features and tools available when visualizing a lineage trace, data model, etc.

Lineage Diagram Show Overview

You may click this Show overview icon to show or hide an Overview panel of the model diagram. Click in the overview to quickly move to a portion of the full diagram.

Lineage Diagram Zoom In/Out and Fit to content

Click Zoom in () or Zoom out () icons to adjust the aspect ratio of the diagram. Also, you may click on the Fit to content ()icon to view the entire diagram at the best zoom that will fit.

Lineage Diagram Collapse / Expand

Click Expand / Collapse to expand or collapse the entire diagram (ensure that you do not have an object selected, otherwise the action will only apply to that object).

Information note

You may also click on the plus sign for an object to expand and the minus sign to collapse just that object.

Lineage Diagram Show actions for the selected object

Show the actions available in the context menu for the selected object.

  • Open to go to the object page for the object
  • Open Lineage to change the point of origin (red pin in diagram) to present a new lineage display.

Lineage Diagram Trace in General

Select the Analysis Diagram tab on the left to obtain this presentation. You will see a graphical presentation of the lineage (data impact or data source).

Additional options include:

Zoom In/Out and Fit to content

Click Zoom in or Zoom out icons to adjust the aspect ratio of the diagram. Also, you may click on the Fit to content icon to view the entire diagram at the best zoom that will fit.

Collapse / Expand

Click Expand / Collapse to expand or collapse the entire diagram (ensure that you do not have an object selected, otherwise the action will only apply to that object).

Information note

You may also click on the plus sign for an object to expand and the minus sign to collapse just that object.

Open the object page

You may right-click and select Open (),to navigate to the object page.

Print

You may download a PNG or SVG image of the diagram.

Quick find

In the upper right, there is a search text box that will provide a quick list of object names that contain the text you type. You may click on any of the results to select that object in the diagram and moving the focus there.

Explore Further

Invoking a lineage trace from any reference to an object

You may invoke a lineage trace from any diagram or any list of results (e.g., from a Browse or Search), either via right-click context menu

Details Panel

Click to select a object and view its Overview page properties in the Details Panel on the right. You may show and hide this panel as needed.

Lineage Diagram Display Options

The Display Options are available.

  • Show Term Definitions – Show semantic lineage back to glossary terms for those which provide definitions of objects in the data flow lineage
  • Compact View – Toggles between small boxes with icons and wider boxes with more text and detail.
  • Show Conditional Labels – Display conditional labels in the diagram as selected in Edit Conditional Labels.
  • Edit Conditional Labels – Pick the conditional labels to display
  • MAXIMUM NODE WIDTH – set the size of the object boxes.

Lineage Diagram Options Show Term Definitions

Here you may see the terms with Defined by relationships in the diagram.

Lineage Diagram Options Compact View

Lineage Diagram Options Show Conditional Labels

Click on the Display Options icon and click Show Conditional Labels

Here, you may pick and choose conditional labels to show in the diagram and the image shows all of them selected for display.

Lineage Diagram Options Maximum Node Width

In many cases, names of objects may be too long to fit into the objects in the diagram. You may specify several different node width maximums to make the diagram more readable. Click on Display Options.

Pick the note width.

Data Flow Settings

AUTO REFRESH

Allows you to control the refresh of the diagram:

  • Yes – Refresh diagram as soon as a setting is made
  • No – Shows a Run button to refresh of the diagram.

HIDE LOOPS

Option to hide lineage loops in the Diagram.

SHOW GRAPH COUNTS

Option to show the counts of objects lines in the Diagram.

TROUBLESHOOTING

Generally, when reporting a support ticket for a lineage diagram issue, you may use these options to provide details and an export to reproduce.

Show Logs

Use the SAVE LOG button to save as text (so it is searchable).

Show Graph Statistics

Export Graph

You may export a graph to be reproduced when reporting an issue. It is exported as a JSON file.

Import Graph

You may import and exported graph.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!