# OpenLineage facet, defined with a sourced example

GLOSSARY, read 10 Nov 2026

**The short answer.** An extension block attached to a run, job or dataset in an OpenLineage event. Facets carry extra detail such as column mappings, SQL text or owners. Anyone can define a custom facet without changing the core spec. OpenLineage's columnLineage dataset facet records which input columns are used to produce which output columns.

## Definition

An extension block attached to a run, job or dataset in an OpenLineage event. Facets carry extra detail such as column mappings, SQL text or owners. Anyone can define a custom facet without changing the core spec.

## Example from a real tool

**Example.** OpenLineage's columnLineage dataset facet records which input columns are used to produce which output columns.

## Related terms

- [Marquez](/glossary/marquez/): The open-source reference implementation of the OpenLineage API.
- [run event](/glossary/run-event/): A single OpenLineage message saying that a job run started, completed or failed, with its input and output datasets.
- [OpenLineage](/glossary/openlineage/): An open standard for describing lineage events, hosted by the LF AI & Data Foundation.

## Where to read more

- [The Lineage Depth Matrix](/matrix/)
- [All glossary terms](/glossary/)

## Sources

- openlineage.io/docs/spec/facets/dataset-facets/column_lineage_facet: https://openlineage.io/docs/spec/facets/dataset-facets/column_lineage_facet (read 10 Nov 2026)

Last reviewed 10 Nov 2026. Canonical: https://datalineagecompare.com/glossary/openlineage-facet/
