trigger

Elena Kostyuchenko

Definition

Triggers a new DAG run. If the DAG is paused, then DAG run state will remain queued and the task will not run.

Usage

$ airflow dags trigger [-h] [-c CONF] [-e EXEC_DATE] [--no-replace-microseconds]
                     [-o table, json, yaml, plain] [-r RUN_ID] [-S SUBDIR]
                     [-v]
                     dag_id

Arguments

Parameter Description

dag_id

The ID of the DAG

-c, --conf

JSON string that gets pickled into the DAG run conf attribute

-e, --exec-date

DAG execution date

--no-replace-microseconds

Whether microseconds should be zeroed

-r, --run-id

Run ID

-S, --subdir

File or directory location for DAGs. Defaults to [AIRFLOW_HOME]/dags, where [AIRFLOW_HOME] is the value set for AIRFLOW_HOME config in airflow.cfg

-o, --output

Output format. Possible values: table, json, yaml, plain. Default: table

-h, --help

Print out the help manual for this command

-v, --verbose

Make logging output more verbose

Examples

To trigger the tutorial DAG, run:

$ airflow dags trigger tutorial

Output example:

     |          |              | data_interva | data_interva |          | external_tri | last_schedul | logical_dat |          |            |
conf | dag_id   | dag_run_id   | l_end        | l_start      | end_date | gger         | ing_decision | e           | run_type | start_date | state
=====+==========+==============+==============+==============+==========+==============+==============+=============+==========+============+=======
{}   | tutorial | manual__2025 | 2025-04-04T0 | 2025-04-04T0 | None     | True         | None         | 2025-04-04T | manual   | None       | queued
     |          | -04-04T05:16 | 5:16:28+00:0 | 5:16:28+00:0 |          |              |              | 05:16:28+00 |          |            |
     |          | :28+00:00    | 0            | 0            |          |              |              | :00         |          |            |
Found a mistake? Seleсt text and press Ctrl+Enter to report it