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.13
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.13.tar.gz | 61.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| acryl_datahub_airflow_plugin-1.7.0.13-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 141.5 kB
Release files / acryl_datahub_airflow_plugin-1.7.0.13.tar.gz
| Download URL | acryl_datahub_airflow_plugin-1.7.0.13.tar.gz |
|---|---|
| Size | 61.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2725b80d9ef01e094260ad2ca32e8d97d003f74246c76ea8cbdac8fb5d699f14
|
|
BLAKE2b-256 checksum How to use checksums |
34ce06475c0a2f415d46f717564ee43d72cf875ddf4435cc35c9a8f3f7763375
|
| 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.13-py3-none-any.whl
| Download URL | acryl_datahub_airflow_plugin-1.7.0.13-py3-none-any.whl |
|---|---|
| Size | 80.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2f0ba13f5e53e1516b38096f9158a467d9cd84549f2346259a142ffaa8ad7df6
|
|
BLAKE2b-256 checksum How to use checksums |
d7c85b02d717ee664580d9edd807919da816b3950cb9749f5f3b53c7d916b032
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.21
|