Getting started with Data Lineage
Refer to the Early Access page to view current programs and request Early Access for a specific feature.
Overview
Data Lineage is a metadata visualization and governance feature in Meta Hub. It shows how data flows between systems and how data relates to the business terms that describe it.
With Data Lineage, you can:
- Visualize data flow – Follow data from source systems through transformations to destinations.
- Identify data relationships – Discover connections between data across Data Hub, Boomi Data Integration, and connected external systems.
Data Lineage is particularly useful for:
- Data stewards and governance teams managing data reliability and dependencies.
- Data Integration developers understanding data dependencies and planning refactoring.
- Data architects building semantic maps of enterprise data estates.
Key concepts
Design-time lineage – Lineage reflects how your models and data flows are configured, not what happens when they run. It doesn’t show execution status or failures.
Lineage graph – A visual map of entities and the relationships between them.
- Entity (node) – A data object Meta Hub tracks, such as a table, model, API, or process.
- Edge – A relationship between two entities, such as data flowing from one to another, or a business glossary term that governs a model
- Base node – The entity you opened the graph from, labeled BASE.
- Upstream – Entities that feed data into the selected node.
- Downstream – Entities that consume data from the selected node.
Node types
- Asset – A data object that stores or represents data, such as a Data Hub model, golden records.
- Service – A platform component or system that processes or moves data between assets, such as a Data Hub universe.
- Transformation – Logic that changes data as it moves, such as a map.
- Semantic – A business concept that gives data meaning, such as a business glossary from Meta Hub.
Category – A more specific classification within a type. For example, Data Hub models are in the Model category, and business glossaries are in the Term category.
Prerequisites
To access and use Data Lineage, you need the following:
Platform access
- A Boomi account with access to Meta Hub and Data Lineage services.
- Data Lineage Early Access enabled on your account. To request access, submit the Early Access form.
User privileges
Create a custom role with the following privileges and assign it to users. For details on creating custom roles, reference Creating custom roles.
| Privilege | Permissions |
|---|---|
| META - View Lineage | Read access to lineage graphs, nodes, and edges. |
| META - View Lineage Edge Trust State History | View the audit history of lineage edge trust state changes. |
System requirements
- Browser Compatibility – Latest versions of Google Chrome, Microsoft Edge, or Mozilla Firefox are supported.
- Network Permissions – Ensure firewall and security settings allow access to the Boomi Platform.
Lineage sources
Data Lineage can automatically capture lineage from:
- Data Hub – Entity models, relationships, and semantic definitions.
- Data Integration – Data Flows, sources, and targets.
- Glossary associations – Business glossary terms associated with Data Hub models.
Configuration
Before users can view lineage, complete the following setup.
1. Create a custom role
- Create a custom role with the Data Lineage privileges listed in Prerequisites, and assign it to users. For details, see Creating custom roles.
2. Set up lineage sources
Data Lineage discovers relationships automatically from the following configurations:
- Data Hub models – Create a model, then publish it, deploy it, and enable initial load.
- Data Integration Data Flows – Configure Source to Target flows.
3. Attach glossaries to Data Hub models
- In Meta Hub, create and publish a business glossary.
- In Data Hub, open the model and attach the business glossary. For steps, see Attaching a glossary in Data Hub.
The lineage graph shows each attached business glossary as a semantic node linked to the model.