OpenLineage dbt integration
Wrapper script for automatic metadata collection from dbt
Features
Metadata
- Model run lifecycle
- Model inputs / outputs
Requirements
Right now, openlineage-dbt only supports bigquery, snowflake, spark and redshift dbt adapters.
Installation
$ pip3 install openlineage-dbt
To install from source, run:
$ pip install .
Configuration
HTTP Backend Environment Variables
openlineage-dbt uses the OpenLineage client to push data to the OpenLineage backend.
The OpenLineage client depends on environment variables:
OPENLINEAGE_URL- point to service which will consume OpenLineage eventsOPENLINEAGE_API_KEY- set if consumer of OpenLineage events requiresBearerauthentication keyOPENLINEAGE_NAMESPACE- set if you are using something other than thedefaultnamespace for job namespace.
Logging
In addition to conventional logging approaches, the OpenLineage dbt wrapper script provides an alternative way of configuring its logging behavior. By setting the OPENLINEAGE_DBT_LOGGING environment variable, you can establish the logging level for the openlineage.dbt and its child modules.
You can also set log level of dbtol which is deprecated.
Usage
To begin collecting dbt metadata with OpenLineage, replace dbt run with dbt-ol run.
Additional table and column level metadata will be available if catalog.json, a result of running dbt docs generate, will be found in the target directory.
If you need to send events without running the job you can use the command dbt-ol send-events, it will send the metadata of your last run without running the job.
SPDX-License-Identifier: Apache-2.0
Copyright 2018-2025 contributors to the OpenLineage project
1 maintainer
Metadata
1 maintainer
Release files for openlineage-dbt 1.29.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| openlineage_dbt-1.29.0.tar.gz | 6.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| openlineage_dbt-1.29.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 12.8 kB
Release files / openlineage_dbt-1.29.0.tar.gz
| Download URL | openlineage_dbt-1.29.0.tar.gz |
|---|---|
| Size | 6.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
393c079de4f5ad0dc71fc0cf5c5654633455f24c28ec5b4a0def5e47fc655279
|
|
BLAKE2b-256 checksum How to use checksums |
ff7fdd86e113d4b177cddc7b7cc8fd6d8f3af12ef411baa27480a651d475f611
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.8.20
|
Release files / openlineage_dbt-1.29.0-py3-none-any.whl
| Download URL | openlineage_dbt-1.29.0-py3-none-any.whl |
|---|---|
| Size | 6.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
21b57e982dde66ea5f79998956cc52adf536ccf375cb9be7588a1954005cf426
|
|
BLAKE2b-256 checksum How to use checksums |
6b40f646f783cb141182a74daa0f096c0d4ba9683a5ebb86d56d200ac536a6be
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.8.20
|
