Skip to main content

​
Overview

The OpenLineage integration for dbt captures lineage metadata from your data transformations automatically. A comprehensive guide on how to configure and use the OpenLineage integration with dbt can be found at OpenLineage documentation.

​
Getting Started

​
Requirements

  • Python 3.8+
  • An existing dbt project

​
Install

Install the OpenLineage dbt wrapper: 
pip install openlineage-dbt

​
oleander API Key

Go to https://oleander.dev, then copy your API key.

​
Configure

Set the following environment variables: 
export OPENLINEAGE_URL=https://oleander.dev
export OPENLINEAGE_API_KEY=[OLEANDER-API-KEY]

​
Run

Replace your usual dbt run command with dbt-ol to begin collecting lineage metadata: 
dbt-ol run
The dbt-ol wrapper supports all standard dbt commands. For example: 
dbt-ol test
dbt-ol build
dbt-ol seed
Finally, go to https://oleander.dev to view the OpenLineage events emitted by your dbt models.