xcom
Example DAG demonstrating the usage of XComs.
Airflow Fundamentals
Providers:
Modules:
Run this DAG
1. Install the Astronomer CLI:Skip if you already have the CLI
2. Initate the project in a local directory:
3. Copy and paste the code below into a file in thedags
directory.
4. Run the DAG from the local directory where the project was initiated:
## Licensed to the Apache Software Foundation (ASF) under one# or more contributor license agreements. See the NOTICE file# distributed with this work for additional information# regarding copyright ownership. The ASF licenses this file# to you under the Apache License, Version 2.0 (the# "License"); you may not use this file except in compliance# with the License. You may obtain a copy of the License at## http://www.apache.org/licenses/LICENSE-2.0## Unless required by applicable law or agreed to in writing,# software distributed under the License is distributed on an# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY# KIND, either express or implied. See the License for the# specific language governing permissions and limitations# under the License."""Example DAG demonstrating the usage of XComs."""from __future__ import annotationsimport pendulumfrom airflow.decorators import taskfrom airflow.models.dag import DAGfrom airflow.models.xcom_arg import XComArgfrom airflow.operators.bash import BashOperatorvalue_1 = [1, 2, 3]value_2 = {"a": "b"}@taskdef push(ti=None):"""Pushes an XCom without a specific target"""ti.xcom_push(key="value from pusher 1", value=value_1)@taskdef push_by_returning():"""Pushes an XCom without a specific target, just by returning it"""return value_2def _compare_values(pulled_value, check_value):if pulled_value != check_value:raise ValueError(f"The two values differ {pulled_value} and {check_value}")@taskdef puller(pulled_value_2, ti=None):"""Pull all previously pushed XComs and check if the pushed values match the pulled values."""pulled_value_1 = ti.xcom_pull(task_ids="push", key="value from pusher 1")_compare_values(pulled_value_1, value_1)_compare_values(pulled_value_2, value_2)@taskdef pull_value_from_bash_push(ti=None):bash_pushed_via_return_value = ti.xcom_pull(key="return_value", task_ids="bash_push")bash_manually_pushed_value = ti.xcom_pull(key="manually_pushed_value", task_ids="bash_push")print(f"The xcom value pushed by task push via return value is {bash_pushed_via_return_value}")print(f"The xcom value pushed by task push manually is {bash_manually_pushed_value}")with DAG("example_xcom",schedule="@once",start_date=pendulum.datetime(2021, 1, 1, tz="UTC"),catchup=False,tags=["example"],) as dag:bash_push = BashOperator(task_id="bash_push",bash_command='echo "bash_push demo" && ''echo "Manually set xcom value ''{{ ti.xcom_push(key="manually_pushed_value", value="manually_pushed_value") }}" && ''echo "value_by_return"',)bash_pull = BashOperator(task_id="bash_pull",bash_command='echo "bash pull demo" && 'f'echo "The xcom pushed manually is {XComArg(bash_push, key="manually_pushed_value")}" && 'f'echo "The returned_value xcom is {XComArg(bash_push)}" && ''echo "finished"',do_xcom_push=False,)python_pull_from_bash = pull_value_from_bash_push()[bash_pull, python_pull_from_bash] << bash_pushpuller(push_by_returning()) << push()