DataHub Airflow Plugin
Automatic lineage and run metadata from Apache Airflow into DataHub — captures DAG structure, task inputs/outputs, and run history with no manual instrumentation.
What you can do
- Capture pipeline lineage — automatically extract dataset-level and column-level lineage from SQL operators
- Track run history — record task execution status, duration, and failures in DataHub
- Enhance OpenLineage — patches Airflow's OpenLineage extractors with DataHub's advanced SQL parser for richer lineage
- Support multiple emitters — send metadata via REST, Kafka, or file
Version compatibility
| Airflow Version | Support |
|---|---|
| 3.0+ | ✅ Fully supported |
| 2.x | ❌ Use acryl-datahub-airflow-plugin <= 1.6.0 |
Installation
pip install acryl-datahub-airflow-plugin
# With Kafka emitter
pip install 'acryl-datahub-airflow-plugin[datahub-kafka]'
Configuration
Add to airflow.cfg:
[datahub]
enabled = True
conn_id = datahub_rest_default # Airflow connection pointing to your DataHub GMS
Set up the Airflow connection:
airflow connections add datahub_rest_default \
--conn-type HTTP \
--conn-host http://localhost:8080
The plugin activates automatically — no changes to your DAG code required.
Key configuration options
| Option | Default | Description |
|---|---|---|
enable_extractors |
True |
Enhance OpenLineage extractors |
patch_sql_parser |
True |
Use DataHub's SQL parser for column-level lineage |
enable_multi_statement_sql_parsing |
False |
Resolve temp tables across multi-statement tasks |
Links
Metadata
Release files for acryl-datahub-airflow-plugin 1.7.0.12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| acryl_datahub_airflow_plugin-1.7.0.12.tar.gz | 58.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| acryl_datahub_airflow_plugin-1.7.0.12-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 134.1 kB
Release files / acryl_datahub_airflow_plugin-1.7.0.12.tar.gz
| Download URL | acryl_datahub_airflow_plugin-1.7.0.12.tar.gz |
|---|---|
| Size | 58.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e58b7ff3f23e8411a8a5f3c0f8f2a95d860b169a17ee4a1a4483a63430656918
|
|
BLAKE2b-256 checksum How to use checksums |
9686505c20323857e5b6318c955476565f8b3d1ec1f3c15aed0ea65b1d391157
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.21
|
Release files / acryl_datahub_airflow_plugin-1.7.0.12-py3-none-any.whl
| Download URL | acryl_datahub_airflow_plugin-1.7.0.12-py3-none-any.whl |
|---|---|
| Size | 75.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
822f603196ed18f1bc7cdc52af5ed1e70c78d5d375a40380d24e7f1052087253
|
|
BLAKE2b-256 checksum How to use checksums |
8c8a2886c56bd9d51b1e3b618070b71a21fe5de476ebb55612bc2766344116db
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.21
|