Supported classes

Below is a list of Operators and Hooks that support OpenLineage extraction, along with specific DB types that are compatible with the supported SQL operators.

Important

While we strive to keep the list of supported classes current, please be aware that our updating process is automated and may not always capture everything accurately. Detecting hook level lineage is challenging so make sure to double check the information provided below.

What does “supported operator” mean?

All Airflow operators will automatically emit OpenLineage events, (unless explicitly disabled or skipped during scheduling, like EmptyOperator) regardless of whether they appear on the “supported” list. Every OpenLineage event will contain basic information such as:

  • Task and DAG run metadata (execution time, state, tags, parameters, owners, description, etc.)

  • Job relationship (DAG job that the task belongs to, upstream/downstream relationship between tasks in a DAG etc.)

  • Error message (in case of task failure)

  • Airflow and OpenLineage provider versions

“Supported” operators provide additional metadata that enhances the lineage information:

  • Input and output datasets (sometimes with Column Level Lineage)

  • Operator-specific details that may include SQL query text and query IDs, source code, job IDs from external systems (e.g., Snowflake or BigQuery job ID), data quality metrics and other information.

For example, a supported SQL operator will include the executed SQL query, query ID, and input/output table information in its OpenLineage events. An unsupported operator will still appear in the lineage graph, but without these details.

Tip

You can easily implement OpenLineage support for any operator. See Implementing OpenLineage in Operators.

Core operators

At the moment, two core operators support OpenLineage. These operators function as a ‘black box,’ capable of running any code, which might limit the extent of lineage extraction (e.g. lineage will usually not contain input/output datasets). To enhance the extraction of lineage information, operators can utilize the hooks listed below that support OpenLineage.

Spark operators

See OpenLineage Spark Integration.

SQL operators

Operators inheriting from BaseSQLOperator may be supported out of the box. These operators can use SQL parsing and may query DB for lineage extraction. To extract unique data from each database type, a dedicated Hook implementing OpenLineage methods is required. Not all subclasses of BaseSQLOperator are automatically supported, only those also using a supported Hook and similar attribute naming convention (e.g., storing query under self.sql).

Important

The level of OpenLineage extraction may vary between SQL operators. Most will provide the executed SQL text, while others may also expose additional metadata such as query IDs or other query-related information. Due to the automatic generation of this documentation, some operators listed as supported SQL operators may not contain full lineage information. Please review the implementation of your operator and its corresponding hook to confirm the level of OpenLineage support.

Currently, the following databases (hooks) are supported together with SQL operators:

Providers

The operators and hooks listed below from each provider are natively equipped with OpenLineage support.

apache-airflow-providers-amazon (9.20.0)

Operators
Hooks

apache-airflow-providers-common-io (1.7.1)

Operators

apache-airflow-providers-common-sql (1.30.3)

SQL operators*

apache-airflow-providers-databricks (7.8.3)

Operators
SQL operators*

apache-airflow-providers-dbt-cloud (4.6.3)

Operators

apache-airflow-providers-exasol (4.9.1)

SQL operators*

apache-airflow-providers-ftp (3.14.1)

Operators

apache-airflow-providers-google (19.4.0)

Operators
SQL operators*
Hooks

apache-airflow-providers-openlineage (2.10.0)

Operators

apache-airflow-providers-pgvector (1.6.1)

SQL operators*

apache-airflow-providers-sftp (5.6.0)

Operators

apache-airflow-providers-snowflake (6.8.2)

Operators
SQL operators*

apache-airflow-providers-teradata (3.4.1)

SQL operators*

apache-airflow-providers-ydb (2.3.2)

SQL operators*

Was this entry helpful?