-
Notifications
You must be signed in to change notification settings - Fork 161
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add docs comparing Airflow and dbt concepts
Also fix Sphinx duplicated reference
- Loading branch information
Showing
3 changed files
with
42 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
.. _dbt-airflow-concepts: | ||
|
||
Similar dbt & Airflow concepts | ||
============================== | ||
|
||
While dbt is an open source tool for data transformations and analysis, using SQL, Airflow focuses on being a platform | ||
for the development, scheduling and monitoring of batch-oriented workflows, using Python. Although both tools have many | ||
differences, they also share similar concepts. | ||
|
||
This page aims to list some of these concepts and help those | ||
who may be new to Airflow or dbt and are considering to use Cosmos. | ||
|
||
|
||
+----------------+--------------+---------------------------------------------------------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------+ | ||
| Airflow naming | dbt naming | Description | Differences | References | | ||
+================+==============+=================================================================================+=============================================================================+======================================================================================+ | ||
| DAG | Workflow | Pipeline (Direct Acyclic Graph) that contains a group of steps | Airflow expects upstream tasks to have passed to run downstream tasks. | https://airflow.apache.org/docs/apache-airflow/2.7.1/core-concepts/dags.html | | ||
| | | | dbt can run a subset of tasks assuming upstream tasks were run. | https://docs.getdbt.com/docs/introduction | | ||
+----------------+--------------+---------------------------------------------------------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------+ | ||
| Task | Node | Step within a pipeline (DAG or workflow) | In dbt, users write mostly SQL and YML to define the steps of a pipeline. | https://docs.getdbt.com/reference/node-selection/syntax | | ||
| | | | Airflow expects steps to be written in Python. | https://airflow.apache.org/docs/apache-airflow/2.7.1/core-concepts/tasks.html | | ||
+----------------+--------------+---------------------------------------------------------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------+ | ||
| Variables | Variables | Key-value configuration that can be used in steps and avoids hard-coded values | | https://docs.getdbt.com/docs/build/project-variables | | ||
| | | | | https://airflow.apache.org/docs/apache-airflow/2.7.1/core-concepts/variables.html | | ||
+----------------+--------------+---------------------------------------------------------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------+ | ||
| Templating | Macros | Jinja templating used to access variables, configuration and reference steps | dbt encourages using jinja templating for control structures (if and for). | https://docs.getdbt.com/docs/build/jinja-macros | | ||
| | | | Airflow usage is limited to variables, macros and filters | https://airflow.apache.org/docs/apache-airflow/stable/templates-ref.html | | ||
+----------------+--------------+---------------------------------------------------------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------+ | ||
| Connection | Profile | Configuration to connect to databases or other services | | https://airflow.apache.org/docs/apache-airflow/stable/howto/connection.html | | ||
| | | | | https://docs.getdbt.com/docs/core/connect-data-platform/connection-profiles | | ||
+----------------+--------------+---------------------------------------------------------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------+ | ||
| Providers | Adapter | Additional Python libraries that support specific databases or services | | https://airflow.apache.org/docs/apache-airflow-providers/ | | ||
| | | | | https://docs.getdbt.com/guides/dbt-ecosystem/adapter-development/1-what-are-adapters | | ||
+----------------+--------------+---------------------------------------------------------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------+ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters