Metadata-Version: 2.1
Name: openlineage-dbt
Version: 0.2.2
Summary: OpenLineage integration with dbt
Home-page: UNKNOWN
Author: OpenLineage
License: UNKNOWN
Keywords: openlineage
Platform: UNKNOWN
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: tests
Provides-Extra: dev

# OpenLineage dbt integration

Wrapper script for dbt for automatic metadata collection

## Features

**Metadata**

* Model run lifecycle
* Model inputs / outputs

## Requirements

- [Python >= 3.6](https://www.python.org/downloads)
- [dbt >= 0.20](https://www.getdbt.com/)

## Installation

```bash
$ pip3 install openlineage-dbt
```

To install from source, run:

```bash
$ pip install .
```

## Configuration


### `HTTP` Backend Environment Variables

`openlineage-dbt` uses OpenLineage client to push data to OpenLineage backend.

OpenLineage client depends on environment variables:

* `OPENLINEAGE_URL` - point to service which will consume OpenLineage events
* `OPENLINEAGE_API_KEY` - set if consumer of OpenLineage events requires `Bearer` authentication key
* `OPENLINEAGE_NAMESPACE` - set if you are using something other than the `default` namespace for job namespace.


## 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`, result of running `dbt docs generate` will be found in target directory.


