01
Where it fits and where it does not
Use these four checks before committing implementation time.
- Use it when
- Operational lineage instrumentation across ETL, ELT, laboratory, feature-engineering, and model-data pipelines.
- Limits
- Lineage is only as complete as its instrumentation; inconsistent naming, missing events, facet-version drift, and backend retention can leave an incomplete history.
- Best for
- AI / ML and Cross-cutting teams working across Acquire → Harmonize → Exchange → Learn + reuse.
- Maturity
- ScalingUsable now, but adoption or tooling is still developing. Pilot the exact stack first.
02
See it in the workflow
This view shows the input, the change the standard introduces, and the resulting output.
- InputWhat starts
AI / ML and Cross-cutting source data, metadata, and local mappings
- OpenLineageWhat changes
Use OpenLineage as a pinned data model / schema across Acquire → Harmonize → Exchange → Learn + reuse
- OutputWhat becomes possible
A handoff the next system or team can validate against the same release
03
A concrete example
An orchestrated transformation emits stable job, run, and dataset identities plus source revision, input and output versions, schemas, quality assertions, and lifecycle events to a lineage backend.
Why it matters: Supports dataset and feature traceability and quality evidence, but does not establish scientific semantics, consent, label validity, or model fitness.
04
What it fits with
Provides event capture that can feed a PROV-O graph; snapshots and summaries can be linked from RO-Crate, DataCite, DQV, or catalog metadata.
- Metadata vocabularyDPV
Both support AI / ML and Cross-cutting work and meet around Acquire, Harmonize, Exchange, Learn + reuse. Compare their roles before treating them as interchangeable.
Explore relationship - StandardISO/IEC 5259
Both support AI / ML and Cross-cutting work and meet around Acquire, Harmonize, Exchange, Learn + reuse. Compare their roles before treating them as interchangeable.
Explore relationship - FrameworkData Cards
Both support AI / ML and Cross-cutting work and meet around Acquire, Harmonize, Exchange, Learn + reuse. Compare their roles before treating them as interchangeable.
Explore relationship - Data model / schemaODCS
Both support AI / ML and Cross-cutting work and meet around Acquire, Harmonize, Exchange, Learn + reuse. Compare their roles before treating them as interchangeable.
Explore relationship
05
Implementation starter
Start with one bounded handoff. Pin, test, and review it before scaling.
Define one handoff, its accountable owner, and the decision OpenLineage must support.
Pin the exact version and companion artifacts: Living specification · documentation 1.50.0.
Map one representative input to the required data model / schema artifacts.
Test the result against the canonical source and record every exception.
Preserve the source data, mappings, and review evidence before scaling.
06
Test the main limitation
Lineage is only as complete as its instrumentation; inconsistent naming, missing events, facet-version drift, and backend retention can leave an incomplete history.
Run one representative end-to-end pilot and record exactly where OpenLineage loses context, needs an extension, or depends on another standard.
Machine-readable output may still be unfit for analysis or ML.
Test the output for missing context, provenance, terminology alignment, time leakage, and the intended downstream decision. Supports dataset and feature traceability and quality evidence, but does not establish scientific semantics, consent, label validity, or model fitness.
07
Official resources
Specifications, diagrams, examples, and guides from the organizations that maintain them.
OpenLineage 1.50.0 object model
Official publisher or steward guidance for this data model / schema profile.
- Publisher
- OpenLineage project