首页/数据/数据工程与 ETL 速查/Airflow CLI 常用命令

Airflow CLI 常用命令

airflow 命令行是排障与操作入口:列 DAG、看任务状态、单任务本地试跑、手动回填、清理历史记录;尽量用 CLI 做可复现操作而不是只在界面点按钮。

看 DAGairflow dags list / dags list-import-errors
看运行airflow tasks states-for-dag-run
本地试跑airflow tasks test <dag> <task> <日期>
回填airflow dags backfill -s -e

排障四连

排障四连
airflow dags list | grep daily_orders
airflow dags list-import-errors
airflow tasks test daily_orders extract 2026-10-11
airflow tasks states-for-dag-run daily_orders manual__2026-10-11T00:00:00+00:00
tasks test 在本地直接执行任务函数、不写调度状态,用来验证逻辑;正式运行仍由 scheduler 发起。

易错点

  • tasks test 不走执行器与队列,测不出 worker 环境依赖问题
  • 排查 DAG 在界面里不见了的问题时,list-import-errors 是常用入口

数据来源与参考

  • Apache Airflow 官方文档:Command Line Interface
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌