blob: f1d4f8202fdeb3d0a5c728a9649629c73c2b25f2 [file] [log] [blame]
<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Command Line Interface &mdash; Airflow Documentation</title>
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="_static/language_data.js"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Scheduling &amp; Triggers" href="scheduler.html" />
<link rel="prev" title="Data Profiling" href="profiling.html" />
<script>
document.addEventListener('DOMContentLoaded', function() {
var el = document.getElementById('changelog');
if (el !== null ) {
// [AIRFLOW-...]
el.innerHTML = el.innerHTML.replace(
/\[(AIRFLOW-[\d]+)\]/g,
`<a href="https://issues.apache.org/jira/browse/$1">[$1]</a>`
);
// (#...)
el.innerHTML = el.innerHTML.replace(
/\(#([\d]+)\)/g,
`<a href="https://github.com/apache/airflow/pull/$1">(#$1)</a>`
);
};
})
</script>
<style>
.example-header {
position: relative;
background: #9AAA7A;
padding: 8px 16px;
margin-bottom: 0;
}
.example-header--with-button {
padding-right: 166px;
}
.example-header:after{
content: '';
display: table;
clear: both;
}
.example-title {
display:block;
padding: 4px;
margin-right: 16px;
color: white;
overflow-x: auto;
}
.example-header-button {
top: 8px;
right: 16px;
position: absolute;
}
.example-header + .highlight-python {
margin-top: 0 !important;
}
.viewcode-button {
display: inline-block;
padding: 8px 16px;
border: 0;
margin: 0;
outline: 0;
border-radius: 2px;
-webkit-box-shadow: 0 3px 5px 0 rgba(0,0,0,.3);
box-shadow: 0 3px 6px 0 rgba(0,0,0,.3);
color: #404040;
background-color: #e7e7e7;
cursor: pointer;
font-size: 16px;
font-weight: 500;
line-height: 1;
text-decoration: none;
text-overflow: ellipsis;
overflow: hidden;
text-transform: uppercase;
-webkit-transition: background-color .2s;
transition: background-color .2s;
vertical-align: middle;
white-space: nowrap;
}
.viewcode-button:visited {
color: #404040;
}
.viewcode-button:hover, .viewcode-button:focus {
color: #404040;
background-color: #d6d6d6;
}
</style>
<!-- Matomo -->
<script>
var _paq = window._paq = window._paq || [];
_paq.push(['disableCookies']);
_paq.push(['trackPageView']);
_paq.push(['enableLinkTracking']);
(function() {
var u="https://analytics.apache.org/";
_paq.push(['setTrackerUrl', u+'matomo.php']);
_paq.push(['setSiteId', '13']);
var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
})();
</script>
<!-- End Matomo -->
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> Airflow
</a>
<div class="version">
1.10.4
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="project.html">Project</a></li>
<li class="toctree-l1"><a class="reference internal" href="license.html">License</a></li>
<li class="toctree-l1"><a class="reference internal" href="start.html">Quick Start</a></li>
<li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>
<li class="toctree-l1"><a class="reference internal" href="tutorial.html">Tutorial</a></li>
<li class="toctree-l1"><a class="reference internal" href="howto/index.html">How-to Guides</a></li>
<li class="toctree-l1"><a class="reference internal" href="ui.html">UI / Screenshots</a></li>
<li class="toctree-l1"><a class="reference internal" href="concepts.html">Concepts</a></li>
<li class="toctree-l1"><a class="reference internal" href="profiling.html">Data Profiling</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Command Line Interface</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#Positional Arguments">Positional Arguments</a></li>
<li class="toctree-l2"><a class="reference internal" href="#Sub-commands:">Sub-commands:</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#backfill">backfill</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Positional Arguments_repeat1">Positional Arguments</a></li>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#list_dag_runs">list_dag_runs</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Positional Arguments_repeat2">Positional Arguments</a></li>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat1">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#list_tasks">list_tasks</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Positional Arguments_repeat3">Positional Arguments</a></li>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat2">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#clear">clear</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Positional Arguments_repeat4">Positional Arguments</a></li>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat3">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#pause">pause</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Positional Arguments_repeat5">Positional Arguments</a></li>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat4">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#unpause">unpause</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Positional Arguments_repeat6">Positional Arguments</a></li>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat5">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#trigger_dag">trigger_dag</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Positional Arguments_repeat7">Positional Arguments</a></li>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat6">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#delete_dag">delete_dag</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Positional Arguments_repeat8">Positional Arguments</a></li>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat7">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#pool">pool</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat8">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#variables">variables</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat9">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#kerberos">kerberos</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Positional Arguments_repeat9">Positional Arguments</a></li>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat10">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#render">render</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Positional Arguments_repeat10">Positional Arguments</a></li>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat11">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#run">run</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Positional Arguments_repeat11">Positional Arguments</a></li>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat12">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#initdb">initdb</a></li>
<li class="toctree-l3"><a class="reference internal" href="#list_dags">list_dags</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat13">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#dag_state">dag_state</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Positional Arguments_repeat12">Positional Arguments</a></li>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat14">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#task_failed_deps">task_failed_deps</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Positional Arguments_repeat13">Positional Arguments</a></li>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat15">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#task_state">task_state</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Positional Arguments_repeat14">Positional Arguments</a></li>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat16">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#serve_logs">serve_logs</a></li>
<li class="toctree-l3"><a class="reference internal" href="#test">test</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Positional Arguments_repeat15">Positional Arguments</a></li>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat17">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#webserver">webserver</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat18">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#resetdb">resetdb</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat19">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#upgradedb">upgradedb</a></li>
<li class="toctree-l3"><a class="reference internal" href="#scheduler">scheduler</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat20">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#worker">worker</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat21">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#flower">flower</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat22">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#version">version</a></li>
<li class="toctree-l3"><a class="reference internal" href="#connections">connections</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat23">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#create_user">create_user</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat24">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#delete_user">delete_user</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat25">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#list_users">list_users</a></li>
<li class="toctree-l3"><a class="reference internal" href="#sync_perm">sync_perm</a></li>
<li class="toctree-l3"><a class="reference internal" href="#next_execution">next_execution</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#Positional Arguments_repeat16">Positional Arguments</a></li>
<li class="toctree-l4"><a class="reference internal" href="#Named Arguments_repeat26">Named Arguments</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#rotate_fernet_key">rotate_fernet_key</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="scheduler.html">Scheduling &amp; Triggers</a></li>
<li class="toctree-l1"><a class="reference internal" href="plugins.html">Plugins</a></li>
<li class="toctree-l1"><a class="reference internal" href="security.html">Security</a></li>
<li class="toctree-l1"><a class="reference internal" href="timezone.html">Time zones</a></li>
<li class="toctree-l1"><a class="reference internal" href="api.html">Experimental Rest API</a></li>
<li class="toctree-l1"><a class="reference internal" href="integration.html">Integration</a></li>
<li class="toctree-l1"><a class="reference internal" href="metrics.html">Metrics</a></li>
<li class="toctree-l1"><a class="reference internal" href="kubernetes.html">Kubernetes</a></li>
<li class="toctree-l1"><a class="reference internal" href="lineage.html">Lineage</a></li>
<li class="toctree-l1"><a class="reference internal" href="changelog.html">Changelog</a></li>
<li class="toctree-l1"><a class="reference internal" href="faq.html">FAQ</a></li>
<li class="toctree-l1"><a class="reference internal" href="macros.html">Macros reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="_api/index.html">API Reference</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">Airflow</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html">Docs</a> &raquo;</li>
<li>Command Line Interface</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/cli.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<div class="section" id="command-line-interface">
<h1>Command Line Interface<a class="headerlink" href="#command-line-interface" title="Permalink to this headline"></a></h1>
<p>Airflow has a very rich command line interface that allows for
many types of operation on a DAG, starting services, and supporting
development and testing.</p>
<div class="contents local topic" id="content">
<p class="topic-title first">Content</p>
<ul class="simple">
<li><p><a class="reference internal" href="#Positional Arguments" id="id1">Positional Arguments</a></p></li>
<li><p><a class="reference internal" href="#Sub-commands:" id="id2">Sub-commands:</a></p>
<ul>
<li><p><a class="reference internal" href="#backfill" id="id3">backfill</a></p></li>
<li><p><a class="reference internal" href="#list_dag_runs" id="id4">list_dag_runs</a></p></li>
<li><p><a class="reference internal" href="#list_tasks" id="id5">list_tasks</a></p></li>
<li><p><a class="reference internal" href="#clear" id="id6">clear</a></p></li>
<li><p><a class="reference internal" href="#pause" id="id7">pause</a></p></li>
<li><p><a class="reference internal" href="#unpause" id="id8">unpause</a></p></li>
<li><p><a class="reference internal" href="#trigger_dag" id="id9">trigger_dag</a></p></li>
<li><p><a class="reference internal" href="#delete_dag" id="id10">delete_dag</a></p></li>
<li><p><a class="reference internal" href="#pool" id="id11">pool</a></p></li>
<li><p><a class="reference internal" href="#variables" id="id12">variables</a></p></li>
<li><p><a class="reference internal" href="#kerberos" id="id13">kerberos</a></p></li>
<li><p><a class="reference internal" href="#render" id="id14">render</a></p></li>
<li><p><a class="reference internal" href="#run" id="id15">run</a></p></li>
<li><p><a class="reference internal" href="#initdb" id="id16">initdb</a></p></li>
<li><p><a class="reference internal" href="#list_dags" id="id17">list_dags</a></p></li>
<li><p><a class="reference internal" href="#dag_state" id="id18">dag_state</a></p></li>
<li><p><a class="reference internal" href="#task_failed_deps" id="id19">task_failed_deps</a></p></li>
<li><p><a class="reference internal" href="#task_state" id="id20">task_state</a></p></li>
<li><p><a class="reference internal" href="#serve_logs" id="id21">serve_logs</a></p></li>
<li><p><a class="reference internal" href="#test" id="id22">test</a></p></li>
<li><p><a class="reference internal" href="#webserver" id="id23">webserver</a></p></li>
<li><p><a class="reference internal" href="#resetdb" id="id24">resetdb</a></p></li>
<li><p><a class="reference internal" href="#upgradedb" id="id25">upgradedb</a></p></li>
<li><p><a class="reference internal" href="#scheduler" id="id26">scheduler</a></p></li>
<li><p><a class="reference internal" href="#worker" id="id27">worker</a></p></li>
<li><p><a class="reference internal" href="#flower" id="id28">flower</a></p></li>
<li><p><a class="reference internal" href="#version" id="id29">version</a></p></li>
<li><p><a class="reference internal" href="#connections" id="id30">connections</a></p></li>
<li><p><a class="reference internal" href="#create_user" id="id31">create_user</a></p></li>
<li><p><a class="reference internal" href="#delete_user" id="id32">delete_user</a></p></li>
<li><p><a class="reference internal" href="#list_users" id="id33">list_users</a></p></li>
<li><p><a class="reference internal" href="#sync_perm" id="id34">sync_perm</a></p></li>
<li><p><a class="reference internal" href="#next_execution" id="id35">next_execution</a></p></li>
<li><p><a class="reference internal" href="#rotate_fernet_key" id="id36">rotate_fernet_key</a></p></li>
</ul>
</li>
</ul>
</div>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">usage</span><span class="p">:</span> <span class="n">airflow</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span>
<span class="p">{</span><span class="n">backfill</span><span class="p">,</span><span class="n">list_dag_runs</span><span class="p">,</span><span class="n">list_tasks</span><span class="p">,</span><span class="n">clear</span><span class="p">,</span><span class="n">pause</span><span class="p">,</span><span class="n">unpause</span><span class="p">,</span><span class="n">trigger_dag</span><span class="p">,</span><span class="n">delete_dag</span><span class="p">,</span><span class="n">pool</span><span class="p">,</span><span class="n">variables</span><span class="p">,</span><span class="n">kerberos</span><span class="p">,</span><span class="n">render</span><span class="p">,</span><span class="n">run</span><span class="p">,</span><span class="n">initdb</span><span class="p">,</span><span class="n">list_dags</span><span class="p">,</span><span class="n">dag_state</span><span class="p">,</span><span class="n">task_failed_deps</span><span class="p">,</span><span class="n">task_state</span><span class="p">,</span><span class="n">serve_logs</span><span class="p">,</span><span class="n">test</span><span class="p">,</span><span class="n">webserver</span><span class="p">,</span><span class="n">resetdb</span><span class="p">,</span><span class="n">upgradedb</span><span class="p">,</span><span class="n">scheduler</span><span class="p">,</span><span class="n">worker</span><span class="p">,</span><span class="n">flower</span><span class="p">,</span><span class="n">version</span><span class="p">,</span><span class="n">connections</span><span class="p">,</span><span class="n">create_user</span><span class="p">,</span><span class="n">delete_user</span><span class="p">,</span><span class="n">list_users</span><span class="p">,</span><span class="n">sync_perm</span><span class="p">,</span><span class="n">next_execution</span><span class="p">,</span><span class="n">rotate_fernet_key</span><span class="p">}</span>
<span class="o">...</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments">
<h2><a class="toc-backref" href="#id1">Positional Arguments</a><a class="headerlink" href="#Positional Arguments" title="Permalink to this headline"></a></h2>
<dl class="option-list">
<dt><kbd>subcommand</kbd></dt>
<dd><p>Possible choices: backfill, list_dag_runs, list_tasks, clear, pause, unpause, trigger_dag, delete_dag, pool, variables, kerberos, render, run, initdb, list_dags, dag_state, task_failed_deps, task_state, serve_logs, test, webserver, resetdb, upgradedb, scheduler, worker, flower, version, connections, create_user, delete_user, list_users, sync_perm, next_execution, rotate_fernet_key</p>
<p>sub-command help</p>
</dd>
</dl>
</div>
<div class="section" id="Sub-commands:">
<h2><a class="toc-backref" href="#id2">Sub-commands:</a><a class="headerlink" href="#Sub-commands:" title="Permalink to this headline"></a></h2>
<div class="section" id="backfill">
<h3><a class="toc-backref" href="#id3">backfill</a><a class="headerlink" href="#backfill" title="Permalink to this headline"></a></h3>
<p>Run subsections of a DAG for a specified date range. If reset_dag_run option is used, backfill will first prompt users whether airflow should clear all the previous dag_run and task_instances within the backfill date range. If rerun_failed_tasks is used, backfill will auto re-run the previous failed task instances within the backfill date range.</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">backfill</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">t</span> <span class="n">TASK_REGEX</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">s</span> <span class="n">START_DATE</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">e</span> <span class="n">END_DATE</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">m</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">l</span><span class="p">]</span>
<span class="p">[</span><span class="o">-</span><span class="n">x</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">i</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">I</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">sd</span> <span class="n">SUBDIR</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">pool</span> <span class="n">POOL</span><span class="p">]</span>
<span class="p">[</span><span class="o">--</span><span class="n">delay_on_limit</span> <span class="n">DELAY_ON_LIMIT</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">dr</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">v</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">c</span> <span class="n">CONF</span><span class="p">]</span>
<span class="p">[</span><span class="o">--</span><span class="n">reset_dagruns</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">rerun_failed_tasks</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">B</span><span class="p">]</span>
<span class="n">dag_id</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments_repeat1">
<h4>Positional Arguments<a class="headerlink" href="#Positional Arguments_repeat1" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>dag_id</kbd></dt>
<dd><p>The id of the dag</p>
</dd>
</dl>
</div>
<div class="section" id="Named Arguments">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-t, --task_regex</kbd></dt>
<dd><p>The regex to filter specific task_ids to backfill (optional)</p>
</dd>
<dt><kbd>-s, --start_date</kbd></dt>
<dd><p>Override start_date YYYY-MM-DD</p>
</dd>
<dt><kbd>-e, --end_date</kbd></dt>
<dd><p>Override end_date YYYY-MM-DD</p>
</dd>
<dt><kbd>-m, --mark_success</kbd></dt>
<dd><p>Mark jobs as succeeded without running them</p>
<p>Default: False</p>
</dd>
<dt><kbd>-l, --local</kbd></dt>
<dd><p>Run the task using the LocalExecutor</p>
<p>Default: False</p>
</dd>
<dt><kbd>-x, --donot_pickle</kbd></dt>
<dd><p>Do not attempt to pickle the DAG object to send over to the workers, just tell the workers to run their version of the code.</p>
<p>Default: False</p>
</dd>
<dt><kbd>-i, --ignore_dependencies</kbd></dt>
<dd><p>Skip upstream tasks, run only the tasks matching the regexp. Only works in conjunction with task_regex</p>
<p>Default: False</p>
</dd>
<dt><kbd>-I, --ignore_first_depends_on_past</kbd></dt>
<dd><p>Ignores depends_on_past dependencies for the first set of tasks only (subsequent executions in the backfill DO respect depends_on_past).</p>
<p>Default: False</p>
</dd>
<dt><kbd>-sd, --subdir</kbd></dt>
<dd><p>File location or directory from which to look for the dag. Defaults to ‘[AIRFLOW_HOME]/dags’ where [AIRFLOW_HOME] is the value you set for ‘AIRFLOW_HOME’ config you set in ‘airflow.cfg’</p>
<p>Default: “[AIRFLOW_HOME]/dags”</p>
</dd>
<dt><kbd>--pool</kbd></dt>
<dd><p>Resource pool to use</p>
</dd>
<dt><kbd>--delay_on_limit</kbd></dt>
<dd><p>Amount of time in seconds to wait when the limit on maximum active dag runs (max_active_runs) has been reached before trying to execute a dag run again.</p>
<p>Default: 1.0</p>
</dd>
<dt><kbd>-dr, --dry_run</kbd></dt>
<dd><p>Perform a dry run</p>
<p>Default: False</p>
</dd>
<dt><kbd>-v, --verbose</kbd></dt>
<dd><p>Make logging output more verbose</p>
<p>Default: False</p>
</dd>
<dt><kbd>-c, --conf</kbd></dt>
<dd><p>JSON string that gets pickled into the DagRun’s conf attribute</p>
</dd>
<dt><kbd>--reset_dagruns</kbd></dt>
<dd><p>if set, the backfill will delete existing backfill-related DAG runs and start anew with fresh, running DAG runs</p>
<p>Default: False</p>
</dd>
<dt><kbd>--rerun_failed_tasks</kbd></dt>
<dd><p>if set, the backfill will auto-rerun all the failed tasks for the backfill date range instead of throwing exceptions</p>
<p>Default: False</p>
</dd>
<dt><kbd>-B, --run_backwards</kbd></dt>
<dd><p>if set, the backfill will run tasks from the most recent day first. if there are tasks that depend_on_past this option will throw an exception</p>
<p>Default: False</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="list_dag_runs">
<h3><a class="toc-backref" href="#id4">list_dag_runs</a><a class="headerlink" href="#list_dag_runs" title="Permalink to this headline"></a></h3>
<p>List dag runs given a DAG id. If state option is given, it will onlysearch for all the dagruns with the given state. If no_backfill option is given, it will filter outall backfill dagruns for given dag id.</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">list_dag_runs</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">no_backfill</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">state</span> <span class="n">STATE</span><span class="p">]</span> <span class="n">dag_id</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments_repeat2">
<h4>Positional Arguments<a class="headerlink" href="#Positional Arguments_repeat2" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>dag_id</kbd></dt>
<dd><p>The id of the dag</p>
</dd>
</dl>
</div>
<div class="section" id="Named Arguments_repeat1">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat1" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>--no_backfill</kbd></dt>
<dd><p>filter all the backfill dagruns given the dag id</p>
<p>Default: False</p>
</dd>
<dt><kbd>--state</kbd></dt>
<dd><p>Only list the dag runs corresponding to the state</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="list_tasks">
<h3><a class="toc-backref" href="#id5">list_tasks</a><a class="headerlink" href="#list_tasks" title="Permalink to this headline"></a></h3>
<p>List the tasks within a DAG</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">list_tasks</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">t</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">sd</span> <span class="n">SUBDIR</span><span class="p">]</span> <span class="n">dag_id</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments_repeat3">
<h4>Positional Arguments<a class="headerlink" href="#Positional Arguments_repeat3" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>dag_id</kbd></dt>
<dd><p>The id of the dag</p>
</dd>
</dl>
</div>
<div class="section" id="Named Arguments_repeat2">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat2" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-t, --tree</kbd></dt>
<dd><p>Tree view</p>
<p>Default: False</p>
</dd>
<dt><kbd>-sd, --subdir</kbd></dt>
<dd><p>File location or directory from which to look for the dag. Defaults to ‘[AIRFLOW_HOME]/dags’ where [AIRFLOW_HOME] is the value you set for ‘AIRFLOW_HOME’ config you set in ‘airflow.cfg’</p>
<p>Default: “[AIRFLOW_HOME]/dags”</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="clear">
<h3><a class="toc-backref" href="#id6">clear</a><a class="headerlink" href="#clear" title="Permalink to this headline"></a></h3>
<p>Clear a set of task instance, as if they never ran</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">clear</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">t</span> <span class="n">TASK_REGEX</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">s</span> <span class="n">START_DATE</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">e</span> <span class="n">END_DATE</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">sd</span> <span class="n">SUBDIR</span><span class="p">]</span>
<span class="p">[</span><span class="o">-</span><span class="n">u</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">d</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">c</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">f</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">r</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">x</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">xp</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">dx</span><span class="p">]</span>
<span class="n">dag_id</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments_repeat4">
<h4>Positional Arguments<a class="headerlink" href="#Positional Arguments_repeat4" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>dag_id</kbd></dt>
<dd><p>The id of the dag</p>
</dd>
</dl>
</div>
<div class="section" id="Named Arguments_repeat3">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat3" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-t, --task_regex</kbd></dt>
<dd><p>The regex to filter specific task_ids to backfill (optional)</p>
</dd>
<dt><kbd>-s, --start_date</kbd></dt>
<dd><p>Override start_date YYYY-MM-DD</p>
</dd>
<dt><kbd>-e, --end_date</kbd></dt>
<dd><p>Override end_date YYYY-MM-DD</p>
</dd>
<dt><kbd>-sd, --subdir</kbd></dt>
<dd><p>File location or directory from which to look for the dag. Defaults to ‘[AIRFLOW_HOME]/dags’ where [AIRFLOW_HOME] is the value you set for ‘AIRFLOW_HOME’ config you set in ‘airflow.cfg’</p>
<p>Default: “[AIRFLOW_HOME]/dags”</p>
</dd>
<dt><kbd>-u, --upstream</kbd></dt>
<dd><p>Include upstream tasks</p>
<p>Default: False</p>
</dd>
<dt><kbd>-d, --downstream</kbd></dt>
<dd><p>Include downstream tasks</p>
<p>Default: False</p>
</dd>
<dt><kbd>-c, --no_confirm</kbd></dt>
<dd><p>Do not request confirmation</p>
<p>Default: False</p>
</dd>
<dt><kbd>-f, --only_failed</kbd></dt>
<dd><p>Only failed jobs</p>
<p>Default: False</p>
</dd>
<dt><kbd>-r, --only_running</kbd></dt>
<dd><p>Only running jobs</p>
<p>Default: False</p>
</dd>
<dt><kbd>-x, --exclude_subdags</kbd></dt>
<dd><p>Exclude subdags</p>
<p>Default: False</p>
</dd>
<dt><kbd>-xp, --exclude_parentdag</kbd></dt>
<dd><p>Exclude ParentDAGS if the task cleared is a part of a SubDAG</p>
<p>Default: False</p>
</dd>
<dt><kbd>-dx, --dag_regex</kbd></dt>
<dd><p>Search dag_id as regex instead of exact string</p>
<p>Default: False</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="pause">
<h3><a class="toc-backref" href="#id7">pause</a><a class="headerlink" href="#pause" title="Permalink to this headline"></a></h3>
<p>Pause a DAG</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">pause</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">sd</span> <span class="n">SUBDIR</span><span class="p">]</span> <span class="n">dag_id</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments_repeat5">
<h4>Positional Arguments<a class="headerlink" href="#Positional Arguments_repeat5" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>dag_id</kbd></dt>
<dd><p>The id of the dag</p>
</dd>
</dl>
</div>
<div class="section" id="Named Arguments_repeat4">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat4" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-sd, --subdir</kbd></dt>
<dd><p>File location or directory from which to look for the dag. Defaults to ‘[AIRFLOW_HOME]/dags’ where [AIRFLOW_HOME] is the value you set for ‘AIRFLOW_HOME’ config you set in ‘airflow.cfg’</p>
<p>Default: “[AIRFLOW_HOME]/dags”</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="unpause">
<h3><a class="toc-backref" href="#id8">unpause</a><a class="headerlink" href="#unpause" title="Permalink to this headline"></a></h3>
<p>Resume a paused DAG</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">unpause</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">sd</span> <span class="n">SUBDIR</span><span class="p">]</span> <span class="n">dag_id</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments_repeat6">
<h4>Positional Arguments<a class="headerlink" href="#Positional Arguments_repeat6" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>dag_id</kbd></dt>
<dd><p>The id of the dag</p>
</dd>
</dl>
</div>
<div class="section" id="Named Arguments_repeat5">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat5" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-sd, --subdir</kbd></dt>
<dd><p>File location or directory from which to look for the dag. Defaults to ‘[AIRFLOW_HOME]/dags’ where [AIRFLOW_HOME] is the value you set for ‘AIRFLOW_HOME’ config you set in ‘airflow.cfg’</p>
<p>Default: “[AIRFLOW_HOME]/dags”</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="trigger_dag">
<h3><a class="toc-backref" href="#id9">trigger_dag</a><a class="headerlink" href="#trigger_dag" title="Permalink to this headline"></a></h3>
<p>Trigger a DAG run</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">trigger_dag</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">sd</span> <span class="n">SUBDIR</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">r</span> <span class="n">RUN_ID</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">c</span> <span class="n">CONF</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">e</span> <span class="n">EXEC_DATE</span><span class="p">]</span>
<span class="n">dag_id</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments_repeat7">
<h4>Positional Arguments<a class="headerlink" href="#Positional Arguments_repeat7" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>dag_id</kbd></dt>
<dd><p>The id of the dag</p>
</dd>
</dl>
</div>
<div class="section" id="Named Arguments_repeat6">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat6" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-sd, --subdir</kbd></dt>
<dd><p>File location or directory from which to look for the dag. Defaults to ‘[AIRFLOW_HOME]/dags’ where [AIRFLOW_HOME] is the value you set for ‘AIRFLOW_HOME’ config you set in ‘airflow.cfg’</p>
<p>Default: “[AIRFLOW_HOME]/dags”</p>
</dd>
<dt><kbd>-r, --run_id</kbd></dt>
<dd><p>Helps to identify this run</p>
</dd>
<dt><kbd>-c, --conf</kbd></dt>
<dd><p>JSON string that gets pickled into the DagRun’s conf attribute</p>
</dd>
<dt><kbd>-e, --exec_date</kbd></dt>
<dd><p>The execution date of the DAG</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="delete_dag">
<h3><a class="toc-backref" href="#id10">delete_dag</a><a class="headerlink" href="#delete_dag" title="Permalink to this headline"></a></h3>
<p>Delete all DB records related to the specified DAG</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">delete_dag</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">y</span><span class="p">]</span> <span class="n">dag_id</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments_repeat8">
<h4>Positional Arguments<a class="headerlink" href="#Positional Arguments_repeat8" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>dag_id</kbd></dt>
<dd><p>The id of the dag</p>
</dd>
</dl>
</div>
<div class="section" id="Named Arguments_repeat7">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat7" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-y, --yes</kbd></dt>
<dd><p>Do not prompt to confirm reset. Use with care!</p>
<p>Default: False</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="pool">
<h3><a class="toc-backref" href="#id11">pool</a><a class="headerlink" href="#pool" title="Permalink to this headline"></a></h3>
<p>CRUD operations on pools</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">pool</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">s</span> <span class="n">NAME</span> <span class="n">SLOT_COUNT</span> <span class="n">POOL_DESCRIPTION</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">g</span> <span class="n">NAME</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">x</span> <span class="n">NAME</span><span class="p">]</span>
<span class="p">[</span><span class="o">-</span><span class="n">i</span> <span class="n">FILEPATH</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">e</span> <span class="n">FILEPATH</span><span class="p">]</span>
</pre></div>
</div>
<div class="section" id="Named Arguments_repeat8">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat8" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-s, --set</kbd></dt>
<dd><p>Set pool slot count and description, respectively</p>
</dd>
<dt><kbd>-g, --get</kbd></dt>
<dd><p>Get pool info</p>
</dd>
<dt><kbd>-x, --delete</kbd></dt>
<dd><p>Delete a pool</p>
</dd>
<dt><kbd>-i, --import</kbd></dt>
<dd><p>Import pool from JSON file</p>
</dd>
<dt><kbd>-e, --export</kbd></dt>
<dd><p>Export pool to JSON file</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="variables">
<h3><a class="toc-backref" href="#id12">variables</a><a class="headerlink" href="#variables" title="Permalink to this headline"></a></h3>
<p>CRUD operations on variables</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">variables</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">s</span> <span class="n">KEY</span> <span class="n">VAL</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">g</span> <span class="n">KEY</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">j</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">d</span> <span class="n">VAL</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">i</span> <span class="n">FILEPATH</span><span class="p">]</span>
<span class="p">[</span><span class="o">-</span><span class="n">e</span> <span class="n">FILEPATH</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">x</span> <span class="n">KEY</span><span class="p">]</span>
</pre></div>
</div>
<div class="section" id="Named Arguments_repeat9">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat9" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-s, --set</kbd></dt>
<dd><p>Set a variable</p>
</dd>
<dt><kbd>-g, --get</kbd></dt>
<dd><p>Get value of a variable</p>
</dd>
<dt><kbd>-j, --json</kbd></dt>
<dd><p>Deserialize JSON variable</p>
<p>Default: False</p>
</dd>
<dt><kbd>-d, --default</kbd></dt>
<dd><p>Default value returned if variable does not exist</p>
</dd>
<dt><kbd>-i, --import</kbd></dt>
<dd><p>Import variables from JSON file</p>
</dd>
<dt><kbd>-e, --export</kbd></dt>
<dd><p>Export variables to JSON file</p>
</dd>
<dt><kbd>-x, --delete</kbd></dt>
<dd><p>Delete a variable</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="kerberos">
<h3><a class="toc-backref" href="#id13">kerberos</a><a class="headerlink" href="#kerberos" title="Permalink to this headline"></a></h3>
<p>Start a kerberos ticket renewer</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">kerberos</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">kt</span> <span class="p">[</span><span class="n">KEYTAB</span><span class="p">]]</span> <span class="p">[</span><span class="o">--</span><span class="n">pid</span> <span class="p">[</span><span class="n">PID</span><span class="p">]]</span> <span class="p">[</span><span class="o">-</span><span class="n">D</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">stdout</span> <span class="n">STDOUT</span><span class="p">]</span>
<span class="p">[</span><span class="o">--</span><span class="n">stderr</span> <span class="n">STDERR</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">l</span> <span class="n">LOG_FILE</span><span class="p">]</span>
<span class="p">[</span><span class="n">principal</span><span class="p">]</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments_repeat9">
<h4>Positional Arguments<a class="headerlink" href="#Positional Arguments_repeat9" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>principal</kbd></dt>
<dd><p>kerberos principal</p>
</dd>
</dl>
</div>
<div class="section" id="Named Arguments_repeat10">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat10" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-kt, --keytab</kbd></dt>
<dd><p>keytab</p>
<p>Default: “airflow.keytab”</p>
</dd>
<dt><kbd>--pid</kbd></dt>
<dd><p>PID file location</p>
</dd>
<dt><kbd>-D, --daemon</kbd></dt>
<dd><p>Daemonize instead of running in the foreground</p>
<p>Default: False</p>
</dd>
<dt><kbd>--stdout</kbd></dt>
<dd><p>Redirect stdout to this file</p>
</dd>
<dt><kbd>--stderr</kbd></dt>
<dd><p>Redirect stderr to this file</p>
</dd>
<dt><kbd>-l, --log-file</kbd></dt>
<dd><p>Location of the log file</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="render">
<h3><a class="toc-backref" href="#id14">render</a><a class="headerlink" href="#render" title="Permalink to this headline"></a></h3>
<p>Render a task instance’s template(s)</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">render</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">sd</span> <span class="n">SUBDIR</span><span class="p">]</span> <span class="n">dag_id</span> <span class="n">task_id</span> <span class="n">execution_date</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments_repeat10">
<h4>Positional Arguments<a class="headerlink" href="#Positional Arguments_repeat10" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>dag_id</kbd></dt>
<dd><p>The id of the dag</p>
</dd>
<dt><kbd>task_id</kbd></dt>
<dd><p>The id of the task</p>
</dd>
<dt><kbd>execution_date</kbd></dt>
<dd><p>The execution date of the DAG</p>
</dd>
</dl>
</div>
<div class="section" id="Named Arguments_repeat11">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat11" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-sd, --subdir</kbd></dt>
<dd><p>File location or directory from which to look for the dag. Defaults to ‘[AIRFLOW_HOME]/dags’ where [AIRFLOW_HOME] is the value you set for ‘AIRFLOW_HOME’ config you set in ‘airflow.cfg’</p>
<p>Default: “[AIRFLOW_HOME]/dags”</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="run">
<h3><a class="toc-backref" href="#id15">run</a><a class="headerlink" href="#run" title="Permalink to this headline"></a></h3>
<p>Run a single task instance</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">run</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">sd</span> <span class="n">SUBDIR</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">m</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">f</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">pool</span> <span class="n">POOL</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">cfg_path</span> <span class="n">CFG_PATH</span><span class="p">]</span>
<span class="p">[</span><span class="o">-</span><span class="n">l</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">A</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">i</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">I</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">ship_dag</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">p</span> <span class="n">PICKLE</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="nb">int</span><span class="p">]</span>
<span class="n">dag_id</span> <span class="n">task_id</span> <span class="n">execution_date</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments_repeat11">
<h4>Positional Arguments<a class="headerlink" href="#Positional Arguments_repeat11" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>dag_id</kbd></dt>
<dd><p>The id of the dag</p>
</dd>
<dt><kbd>task_id</kbd></dt>
<dd><p>The id of the task</p>
</dd>
<dt><kbd>execution_date</kbd></dt>
<dd><p>The execution date of the DAG</p>
</dd>
</dl>
</div>
<div class="section" id="Named Arguments_repeat12">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat12" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-sd, --subdir</kbd></dt>
<dd><p>File location or directory from which to look for the dag. Defaults to ‘[AIRFLOW_HOME]/dags’ where [AIRFLOW_HOME] is the value you set for ‘AIRFLOW_HOME’ config you set in ‘airflow.cfg’</p>
<p>Default: “[AIRFLOW_HOME]/dags”</p>
</dd>
<dt><kbd>-m, --mark_success</kbd></dt>
<dd><p>Mark jobs as succeeded without running them</p>
<p>Default: False</p>
</dd>
<dt><kbd>-f, --force</kbd></dt>
<dd><p>Ignore previous task instance state, rerun regardless if task already succeeded/failed</p>
<p>Default: False</p>
</dd>
<dt><kbd>--pool</kbd></dt>
<dd><p>Resource pool to use</p>
</dd>
<dt><kbd>--cfg_path</kbd></dt>
<dd><p>Path to config file to use instead of airflow.cfg</p>
</dd>
<dt><kbd>-l, --local</kbd></dt>
<dd><p>Run the task using the LocalExecutor</p>
<p>Default: False</p>
</dd>
<dt><kbd>-A, --ignore_all_dependencies</kbd></dt>
<dd><p>Ignores all non-critical dependencies, including ignore_ti_state and ignore_task_deps</p>
<p>Default: False</p>
</dd>
<dt><kbd>-i, --ignore_dependencies</kbd></dt>
<dd><p>Ignore task-specific dependencies, e.g. upstream, depends_on_past, and retry delay dependencies</p>
<p>Default: False</p>
</dd>
<dt><kbd>-I, --ignore_depends_on_past</kbd></dt>
<dd><p>Ignore depends_on_past dependencies (but respect upstream dependencies)</p>
<p>Default: False</p>
</dd>
<dt><kbd>--ship_dag</kbd></dt>
<dd><p>Pickles (serializes) the DAG and ships it to the worker</p>
<p>Default: False</p>
</dd>
<dt><kbd>-p, --pickle</kbd></dt>
<dd><p>Serialized pickle object of the entire dag (used internally)</p>
</dd>
<dt><kbd>-int, --interactive</kbd></dt>
<dd><p>Do not capture standard output and error streams (useful for interactive debugging)</p>
<p>Default: False</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="initdb">
<h3><a class="toc-backref" href="#id16">initdb</a><a class="headerlink" href="#initdb" title="Permalink to this headline"></a></h3>
<p>Initialize the metadata database</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">initdb</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span>
</pre></div>
</div>
</div>
<div class="section" id="list_dags">
<h3><a class="toc-backref" href="#id17">list_dags</a><a class="headerlink" href="#list_dags" title="Permalink to this headline"></a></h3>
<p>List all the DAGs</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">list_dags</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">sd</span> <span class="n">SUBDIR</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">r</span><span class="p">]</span>
</pre></div>
</div>
<div class="section" id="Named Arguments_repeat13">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat13" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-sd, --subdir</kbd></dt>
<dd><p>File location or directory from which to look for the dag. Defaults to ‘[AIRFLOW_HOME]/dags’ where [AIRFLOW_HOME] is the value you set for ‘AIRFLOW_HOME’ config you set in ‘airflow.cfg’</p>
<p>Default: “[AIRFLOW_HOME]/dags”</p>
</dd>
<dt><kbd>-r, --report</kbd></dt>
<dd><p>Show DagBag loading report</p>
<p>Default: False</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="dag_state">
<h3><a class="toc-backref" href="#id18">dag_state</a><a class="headerlink" href="#dag_state" title="Permalink to this headline"></a></h3>
<p>Get the status of a dag run</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">dag_state</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">sd</span> <span class="n">SUBDIR</span><span class="p">]</span> <span class="n">dag_id</span> <span class="n">execution_date</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments_repeat12">
<h4>Positional Arguments<a class="headerlink" href="#Positional Arguments_repeat12" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>dag_id</kbd></dt>
<dd><p>The id of the dag</p>
</dd>
<dt><kbd>execution_date</kbd></dt>
<dd><p>The execution date of the DAG</p>
</dd>
</dl>
</div>
<div class="section" id="Named Arguments_repeat14">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat14" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-sd, --subdir</kbd></dt>
<dd><p>File location or directory from which to look for the dag. Defaults to ‘[AIRFLOW_HOME]/dags’ where [AIRFLOW_HOME] is the value you set for ‘AIRFLOW_HOME’ config you set in ‘airflow.cfg’</p>
<p>Default: “[AIRFLOW_HOME]/dags”</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="task_failed_deps">
<h3><a class="toc-backref" href="#id19">task_failed_deps</a><a class="headerlink" href="#task_failed_deps" title="Permalink to this headline"></a></h3>
<p>Returns the unmet dependencies for a task instance from the perspective of the scheduler. In other words, why a task instance doesn’t get scheduled and then queued by the scheduler, and then run by an executor).</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">task_failed_deps</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">sd</span> <span class="n">SUBDIR</span><span class="p">]</span> <span class="n">dag_id</span> <span class="n">task_id</span> <span class="n">execution_date</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments_repeat13">
<h4>Positional Arguments<a class="headerlink" href="#Positional Arguments_repeat13" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>dag_id</kbd></dt>
<dd><p>The id of the dag</p>
</dd>
<dt><kbd>task_id</kbd></dt>
<dd><p>The id of the task</p>
</dd>
<dt><kbd>execution_date</kbd></dt>
<dd><p>The execution date of the DAG</p>
</dd>
</dl>
</div>
<div class="section" id="Named Arguments_repeat15">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat15" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-sd, --subdir</kbd></dt>
<dd><p>File location or directory from which to look for the dag. Defaults to ‘[AIRFLOW_HOME]/dags’ where [AIRFLOW_HOME] is the value you set for ‘AIRFLOW_HOME’ config you set in ‘airflow.cfg’</p>
<p>Default: “[AIRFLOW_HOME]/dags”</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="task_state">
<h3><a class="toc-backref" href="#id20">task_state</a><a class="headerlink" href="#task_state" title="Permalink to this headline"></a></h3>
<p>Get the status of a task instance</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">task_state</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">sd</span> <span class="n">SUBDIR</span><span class="p">]</span> <span class="n">dag_id</span> <span class="n">task_id</span> <span class="n">execution_date</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments_repeat14">
<h4>Positional Arguments<a class="headerlink" href="#Positional Arguments_repeat14" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>dag_id</kbd></dt>
<dd><p>The id of the dag</p>
</dd>
<dt><kbd>task_id</kbd></dt>
<dd><p>The id of the task</p>
</dd>
<dt><kbd>execution_date</kbd></dt>
<dd><p>The execution date of the DAG</p>
</dd>
</dl>
</div>
<div class="section" id="Named Arguments_repeat16">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat16" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-sd, --subdir</kbd></dt>
<dd><p>File location or directory from which to look for the dag. Defaults to ‘[AIRFLOW_HOME]/dags’ where [AIRFLOW_HOME] is the value you set for ‘AIRFLOW_HOME’ config you set in ‘airflow.cfg’</p>
<p>Default: “[AIRFLOW_HOME]/dags”</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="serve_logs">
<h3><a class="toc-backref" href="#id21">serve_logs</a><a class="headerlink" href="#serve_logs" title="Permalink to this headline"></a></h3>
<p>Serve logs generate by worker</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">serve_logs</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span>
</pre></div>
</div>
</div>
<div class="section" id="test">
<h3><a class="toc-backref" href="#id22">test</a><a class="headerlink" href="#test" title="Permalink to this headline"></a></h3>
<p>Test a task instance. This will run a task without checking for dependencies or recording its state in the database.</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">test</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">sd</span> <span class="n">SUBDIR</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">dr</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">tp</span> <span class="n">TASK_PARAMS</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">pm</span><span class="p">]</span>
<span class="n">dag_id</span> <span class="n">task_id</span> <span class="n">execution_date</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments_repeat15">
<h4>Positional Arguments<a class="headerlink" href="#Positional Arguments_repeat15" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>dag_id</kbd></dt>
<dd><p>The id of the dag</p>
</dd>
<dt><kbd>task_id</kbd></dt>
<dd><p>The id of the task</p>
</dd>
<dt><kbd>execution_date</kbd></dt>
<dd><p>The execution date of the DAG</p>
</dd>
</dl>
</div>
<div class="section" id="Named Arguments_repeat17">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat17" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-sd, --subdir</kbd></dt>
<dd><p>File location or directory from which to look for the dag. Defaults to ‘[AIRFLOW_HOME]/dags’ where [AIRFLOW_HOME] is the value you set for ‘AIRFLOW_HOME’ config you set in ‘airflow.cfg’</p>
<p>Default: “[AIRFLOW_HOME]/dags”</p>
</dd>
<dt><kbd>-dr, --dry_run</kbd></dt>
<dd><p>Perform a dry run</p>
<p>Default: False</p>
</dd>
<dt><kbd>-tp, --task_params</kbd></dt>
<dd><p>Sends a JSON params dict to the task</p>
</dd>
<dt><kbd>-pm, --post_mortem</kbd></dt>
<dd><p>Open debugger on uncaught exception</p>
<p>Default: False</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="webserver">
<h3><a class="toc-backref" href="#id23">webserver</a><a class="headerlink" href="#webserver" title="Permalink to this headline"></a></h3>
<p>Start a Airflow webserver instance</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">webserver</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">p</span> <span class="n">PORT</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">w</span> <span class="n">WORKERS</span><span class="p">]</span>
<span class="p">[</span><span class="o">-</span><span class="n">k</span> <span class="p">{</span><span class="n">sync</span><span class="p">,</span><span class="n">eventlet</span><span class="p">,</span><span class="n">gevent</span><span class="p">,</span><span class="n">tornado</span><span class="p">}]</span> <span class="p">[</span><span class="o">-</span><span class="n">t</span> <span class="n">WORKER_TIMEOUT</span><span class="p">]</span>
<span class="p">[</span><span class="o">-</span><span class="n">hn</span> <span class="n">HOSTNAME</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">pid</span> <span class="p">[</span><span class="n">PID</span><span class="p">]]</span> <span class="p">[</span><span class="o">-</span><span class="n">D</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">stdout</span> <span class="n">STDOUT</span><span class="p">]</span>
<span class="p">[</span><span class="o">--</span><span class="n">stderr</span> <span class="n">STDERR</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">A</span> <span class="n">ACCESS_LOGFILE</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">E</span> <span class="n">ERROR_LOGFILE</span><span class="p">]</span>
<span class="p">[</span><span class="o">-</span><span class="n">l</span> <span class="n">LOG_FILE</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">ssl_cert</span> <span class="n">SSL_CERT</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">ssl_key</span> <span class="n">SSL_KEY</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">d</span><span class="p">]</span>
</pre></div>
</div>
<div class="section" id="Named Arguments_repeat18">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat18" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-p, --port</kbd></dt>
<dd><p>The port on which to run the server</p>
<p>Default: 8080</p>
</dd>
<dt><kbd>-w, --workers</kbd></dt>
<dd><p>Number of workers to run the webserver on</p>
<p>Default: 1</p>
</dd>
<dt><kbd>-k, --workerclass</kbd></dt>
<dd><p>Possible choices: sync, eventlet, gevent, tornado</p>
<p>The worker class to use for Gunicorn</p>
<p>Default: “sync”</p>
</dd>
<dt><kbd>-t, --worker_timeout</kbd></dt>
<dd><p>The timeout for waiting on webserver workers</p>
<p>Default: 120</p>
</dd>
<dt><kbd>-hn, --hostname</kbd></dt>
<dd><p>Set the hostname on which to run the web server</p>
<p>Default: “0.0.0.0”</p>
</dd>
<dt><kbd>--pid</kbd></dt>
<dd><p>PID file location</p>
</dd>
<dt><kbd>-D, --daemon</kbd></dt>
<dd><p>Daemonize instead of running in the foreground</p>
<p>Default: False</p>
</dd>
<dt><kbd>--stdout</kbd></dt>
<dd><p>Redirect stdout to this file</p>
</dd>
<dt><kbd>--stderr</kbd></dt>
<dd><p>Redirect stderr to this file</p>
</dd>
<dt><kbd>-A, --access_logfile</kbd></dt>
<dd><p>The logfile to store the webserver access log. Use ‘-‘ to print to stderr.</p>
<p>Default: “-“</p>
</dd>
<dt><kbd>-E, --error_logfile</kbd></dt>
<dd><p>The logfile to store the webserver error log. Use ‘-‘ to print to stderr.</p>
<p>Default: “-“</p>
</dd>
<dt><kbd>-l, --log-file</kbd></dt>
<dd><p>Location of the log file</p>
</dd>
<dt><kbd>--ssl_cert</kbd></dt>
<dd><p>Path to the SSL certificate for the webserver</p>
</dd>
<dt><kbd>--ssl_key</kbd></dt>
<dd><p>Path to the key to use with the SSL certificate</p>
</dd>
<dt><kbd>-d, --debug</kbd></dt>
<dd><p>Use the server that ships with Flask in debug mode</p>
<p>Default: False</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="resetdb">
<h3><a class="toc-backref" href="#id24">resetdb</a><a class="headerlink" href="#resetdb" title="Permalink to this headline"></a></h3>
<p>Burn down and rebuild the metadata database</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">resetdb</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">y</span><span class="p">]</span>
</pre></div>
</div>
<div class="section" id="Named Arguments_repeat19">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat19" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-y, --yes</kbd></dt>
<dd><p>Do not prompt to confirm reset. Use with care!</p>
<p>Default: False</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="upgradedb">
<h3><a class="toc-backref" href="#id25">upgradedb</a><a class="headerlink" href="#upgradedb" title="Permalink to this headline"></a></h3>
<p>Upgrade the metadata database to latest version</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">upgradedb</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span>
</pre></div>
</div>
</div>
<div class="section" id="scheduler">
<h3><a class="toc-backref" href="#id26">scheduler</a><a class="headerlink" href="#scheduler" title="Permalink to this headline"></a></h3>
<p>Start a scheduler instance</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">scheduler</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">d</span> <span class="n">DAG_ID</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">sd</span> <span class="n">SUBDIR</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">r</span> <span class="n">RUN_DURATION</span><span class="p">]</span>
<span class="p">[</span><span class="o">-</span><span class="n">n</span> <span class="n">NUM_RUNS</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">p</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">pid</span> <span class="p">[</span><span class="n">PID</span><span class="p">]]</span> <span class="p">[</span><span class="o">-</span><span class="n">D</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">stdout</span> <span class="n">STDOUT</span><span class="p">]</span>
<span class="p">[</span><span class="o">--</span><span class="n">stderr</span> <span class="n">STDERR</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">l</span> <span class="n">LOG_FILE</span><span class="p">]</span>
</pre></div>
</div>
<div class="section" id="Named Arguments_repeat20">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat20" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-d, --dag_id</kbd></dt>
<dd><p>The id of the dag to run</p>
</dd>
<dt><kbd>-sd, --subdir</kbd></dt>
<dd><p>File location or directory from which to look for the dag. Defaults to ‘[AIRFLOW_HOME]/dags’ where [AIRFLOW_HOME] is the value you set for ‘AIRFLOW_HOME’ config you set in ‘airflow.cfg’</p>
<p>Default: “[AIRFLOW_HOME]/dags”</p>
</dd>
<dt><kbd>-r, --run-duration</kbd></dt>
<dd><p>Set number of seconds to execute before exiting</p>
</dd>
<dt><kbd>-n, --num_runs</kbd></dt>
<dd><p>Set the number of runs to execute before exiting</p>
<p>Default: -1</p>
</dd>
<dt><kbd>-p, --do_pickle</kbd></dt>
<dd><p>Attempt to pickle the DAG object to send over to the workers, instead of letting workers run their version of the code.</p>
<p>Default: False</p>
</dd>
<dt><kbd>--pid</kbd></dt>
<dd><p>PID file location</p>
</dd>
<dt><kbd>-D, --daemon</kbd></dt>
<dd><p>Daemonize instead of running in the foreground</p>
<p>Default: False</p>
</dd>
<dt><kbd>--stdout</kbd></dt>
<dd><p>Redirect stdout to this file</p>
</dd>
<dt><kbd>--stderr</kbd></dt>
<dd><p>Redirect stderr to this file</p>
</dd>
<dt><kbd>-l, --log-file</kbd></dt>
<dd><p>Location of the log file</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="worker">
<h3><a class="toc-backref" href="#id27">worker</a><a class="headerlink" href="#worker" title="Permalink to this headline"></a></h3>
<p>Start a Celery worker node</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">worker</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">p</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">q</span> <span class="n">QUEUES</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">c</span> <span class="n">CONCURRENCY</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">cn</span> <span class="n">CELERY_HOSTNAME</span><span class="p">]</span>
<span class="p">[</span><span class="o">--</span><span class="n">pid</span> <span class="p">[</span><span class="n">PID</span><span class="p">]]</span> <span class="p">[</span><span class="o">-</span><span class="n">D</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">stdout</span> <span class="n">STDOUT</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">stderr</span> <span class="n">STDERR</span><span class="p">]</span>
<span class="p">[</span><span class="o">-</span><span class="n">l</span> <span class="n">LOG_FILE</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">a</span> <span class="n">AUTOSCALE</span><span class="p">]</span>
</pre></div>
</div>
<div class="section" id="Named Arguments_repeat21">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat21" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-p, --do_pickle</kbd></dt>
<dd><p>Attempt to pickle the DAG object to send over to the workers, instead of letting workers run their version of the code.</p>
<p>Default: False</p>
</dd>
<dt><kbd>-q, --queues</kbd></dt>
<dd><p>Comma delimited list of queues to serve</p>
<p>Default: “default”</p>
</dd>
<dt><kbd>-c, --concurrency</kbd></dt>
<dd><p>The number of worker processes</p>
<p>Default: 4</p>
</dd>
<dt><kbd>-cn, --celery_hostname</kbd></dt>
<dd><p>Set the hostname of celery worker if you have multiple workers on a single machine.</p>
</dd>
<dt><kbd>--pid</kbd></dt>
<dd><p>PID file location</p>
</dd>
<dt><kbd>-D, --daemon</kbd></dt>
<dd><p>Daemonize instead of running in the foreground</p>
<p>Default: False</p>
</dd>
<dt><kbd>--stdout</kbd></dt>
<dd><p>Redirect stdout to this file</p>
</dd>
<dt><kbd>--stderr</kbd></dt>
<dd><p>Redirect stderr to this file</p>
</dd>
<dt><kbd>-l, --log-file</kbd></dt>
<dd><p>Location of the log file</p>
</dd>
<dt><kbd>-a, --autoscale</kbd></dt>
<dd><p>Minimum and Maximum number of worker to autoscale</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="flower">
<h3><a class="toc-backref" href="#id28">flower</a><a class="headerlink" href="#flower" title="Permalink to this headline"></a></h3>
<p>Start a Celery Flower</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">flower</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">hn</span> <span class="n">HOSTNAME</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">p</span> <span class="n">PORT</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">fc</span> <span class="n">FLOWER_CONF</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">u</span> <span class="n">URL_PREFIX</span><span class="p">]</span>
<span class="p">[</span><span class="o">-</span><span class="n">ba</span> <span class="n">BASIC_AUTH</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">a</span> <span class="n">BROKER_API</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">pid</span> <span class="p">[</span><span class="n">PID</span><span class="p">]]</span> <span class="p">[</span><span class="o">-</span><span class="n">D</span><span class="p">]</span>
<span class="p">[</span><span class="o">--</span><span class="n">stdout</span> <span class="n">STDOUT</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">stderr</span> <span class="n">STDERR</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">l</span> <span class="n">LOG_FILE</span><span class="p">]</span>
</pre></div>
</div>
<div class="section" id="Named Arguments_repeat22">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat22" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-hn, --hostname</kbd></dt>
<dd><p>Set the hostname on which to run the server</p>
<p>Default: “0.0.0.0”</p>
</dd>
<dt><kbd>-p, --port</kbd></dt>
<dd><p>The port on which to run the server</p>
<p>Default: 5555</p>
</dd>
<dt><kbd>-fc, --flower_conf</kbd></dt>
<dd><p>Configuration file for flower</p>
</dd>
<dt><kbd>-u, --url_prefix</kbd></dt>
<dd><p>URL prefix for Flower</p>
</dd>
<dt><kbd>-ba, --basic_auth</kbd></dt>
<dd><p>Securing Flower with Basic Authentication. Accepts user:password pairs separated by a comma. Example: flower_basic_auth = user1:password1,user2:password2</p>
</dd>
<dt><kbd>-a, --broker_api</kbd></dt>
<dd><p>Broker api</p>
</dd>
<dt><kbd>--pid</kbd></dt>
<dd><p>PID file location</p>
</dd>
<dt><kbd>-D, --daemon</kbd></dt>
<dd><p>Daemonize instead of running in the foreground</p>
<p>Default: False</p>
</dd>
<dt><kbd>--stdout</kbd></dt>
<dd><p>Redirect stdout to this file</p>
</dd>
<dt><kbd>--stderr</kbd></dt>
<dd><p>Redirect stderr to this file</p>
</dd>
<dt><kbd>-l, --log-file</kbd></dt>
<dd><p>Location of the log file</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="version">
<h3><a class="toc-backref" href="#id29">version</a><a class="headerlink" href="#version" title="Permalink to this headline"></a></h3>
<p>Show the version</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">version</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span>
</pre></div>
</div>
</div>
<div class="section" id="connections">
<h3><a class="toc-backref" href="#id30">connections</a><a class="headerlink" href="#connections" title="Permalink to this headline"></a></h3>
<p>List/Add/Delete connections</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">connections</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">l</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">a</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">d</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">conn_id</span> <span class="n">CONN_ID</span><span class="p">]</span>
<span class="p">[</span><span class="o">--</span><span class="n">conn_uri</span> <span class="n">CONN_URI</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">conn_extra</span> <span class="n">CONN_EXTRA</span><span class="p">]</span>
<span class="p">[</span><span class="o">--</span><span class="n">conn_type</span> <span class="n">CONN_TYPE</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">conn_host</span> <span class="n">CONN_HOST</span><span class="p">]</span>
<span class="p">[</span><span class="o">--</span><span class="n">conn_login</span> <span class="n">CONN_LOGIN</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">conn_password</span> <span class="n">CONN_PASSWORD</span><span class="p">]</span>
<span class="p">[</span><span class="o">--</span><span class="n">conn_schema</span> <span class="n">CONN_SCHEMA</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">conn_port</span> <span class="n">CONN_PORT</span><span class="p">]</span>
</pre></div>
</div>
<div class="section" id="Named Arguments_repeat23">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat23" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-l, --list</kbd></dt>
<dd><p>List all connections</p>
<p>Default: False</p>
</dd>
<dt><kbd>-a, --add</kbd></dt>
<dd><p>Add a connection</p>
<p>Default: False</p>
</dd>
<dt><kbd>-d, --delete</kbd></dt>
<dd><p>Delete a connection</p>
<p>Default: False</p>
</dd>
<dt><kbd>--conn_id</kbd></dt>
<dd><p>Connection id, required to add/delete a connection</p>
</dd>
<dt><kbd>--conn_uri</kbd></dt>
<dd><p>Connection URI, required to add a connection without conn_type</p>
</dd>
<dt><kbd>--conn_extra</kbd></dt>
<dd><p>Connection <cite>Extra</cite> field, optional when adding a connection</p>
</dd>
<dt><kbd>--conn_type</kbd></dt>
<dd><p>Connection type, required to add a connection without conn_uri</p>
</dd>
<dt><kbd>--conn_host</kbd></dt>
<dd><p>Connection host, optional when adding a connection</p>
</dd>
<dt><kbd>--conn_login</kbd></dt>
<dd><p>Connection login, optional when adding a connection</p>
</dd>
<dt><kbd>--conn_password</kbd></dt>
<dd><p>Connection password, optional when adding a connection</p>
</dd>
<dt><kbd>--conn_schema</kbd></dt>
<dd><p>Connection schema, optional when adding a connection</p>
</dd>
<dt><kbd>--conn_port</kbd></dt>
<dd><p>Connection port, optional when adding a connection</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="create_user">
<h3><a class="toc-backref" href="#id31">create_user</a><a class="headerlink" href="#create_user" title="Permalink to this headline"></a></h3>
<p>Create an account for the Web UI (FAB-based)</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">create_user</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">r</span> <span class="n">ROLE</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">u</span> <span class="n">USERNAME</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">e</span> <span class="n">EMAIL</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">f</span> <span class="n">FIRSTNAME</span><span class="p">]</span>
<span class="p">[</span><span class="o">-</span><span class="n">l</span> <span class="n">LASTNAME</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">p</span> <span class="n">PASSWORD</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">use_random_password</span><span class="p">]</span>
</pre></div>
</div>
<div class="section" id="Named Arguments_repeat24">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat24" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-r, --role</kbd></dt>
<dd><p>Role of the user. Existing roles include Admin, User, Op, Viewer, and Public</p>
</dd>
<dt><kbd>-u, --username</kbd></dt>
<dd><p>Username of the user</p>
</dd>
<dt><kbd>-e, --email</kbd></dt>
<dd><p>Email of the user</p>
</dd>
<dt><kbd>-f, --firstname</kbd></dt>
<dd><p>First name of the user</p>
</dd>
<dt><kbd>-l, --lastname</kbd></dt>
<dd><p>Last name of the user</p>
</dd>
<dt><kbd>-p, --password</kbd></dt>
<dd><p>Password of the user</p>
</dd>
<dt><kbd>--use_random_password</kbd></dt>
<dd><p>Do not prompt for password. Use random string instead</p>
<p>Default: False</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="delete_user">
<h3><a class="toc-backref" href="#id32">delete_user</a><a class="headerlink" href="#delete_user" title="Permalink to this headline"></a></h3>
<p>Delete an account for the Web UI</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">delete_user</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">u</span> <span class="n">USERNAME</span><span class="p">]</span>
</pre></div>
</div>
<div class="section" id="Named Arguments_repeat25">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat25" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-u, --username</kbd></dt>
<dd><p>Username of the user</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="list_users">
<h3><a class="toc-backref" href="#id33">list_users</a><a class="headerlink" href="#list_users" title="Permalink to this headline"></a></h3>
<p>List accounts for the Web UI</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">list_users</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span>
</pre></div>
</div>
</div>
<div class="section" id="sync_perm">
<h3><a class="toc-backref" href="#id34">sync_perm</a><a class="headerlink" href="#sync_perm" title="Permalink to this headline"></a></h3>
<p>Update existing role’s permissions.</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">sync_perm</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span>
</pre></div>
</div>
</div>
<div class="section" id="next_execution">
<h3><a class="toc-backref" href="#id35">next_execution</a><a class="headerlink" href="#next_execution" title="Permalink to this headline"></a></h3>
<p>Get the next execution datetime of a DAG.</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">next_execution</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">sd</span> <span class="n">SUBDIR</span><span class="p">]</span> <span class="n">dag_id</span>
</pre></div>
</div>
<div class="section" id="Positional Arguments_repeat16">
<h4>Positional Arguments<a class="headerlink" href="#Positional Arguments_repeat16" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>dag_id</kbd></dt>
<dd><p>The id of the dag</p>
</dd>
</dl>
</div>
<div class="section" id="Named Arguments_repeat26">
<h4>Named Arguments<a class="headerlink" href="#Named Arguments_repeat26" title="Permalink to this headline"></a></h4>
<dl class="option-list">
<dt><kbd>-sd, --subdir</kbd></dt>
<dd><p>File location or directory from which to look for the dag. Defaults to ‘[AIRFLOW_HOME]/dags’ where [AIRFLOW_HOME] is the value you set for ‘AIRFLOW_HOME’ config you set in ‘airflow.cfg’</p>
<p>Default: “[AIRFLOW_HOME]/dags”</p>
</dd>
</dl>
</div>
</div>
<div class="section" id="rotate_fernet_key">
<h3><a class="toc-backref" href="#id36">rotate_fernet_key</a><a class="headerlink" href="#rotate_fernet_key" title="Permalink to this headline"></a></h3>
<p>Rotate all encrypted connection credentials and variables; see <a class="reference external" href="https://airflow.readthedocs.io/en/stable/howto/secure-connections.html#rotating-encryption-keys">https://airflow.readthedocs.io/en/stable/howto/secure-connections.html#rotating-encryption-keys</a>.</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">airflow</span> <span class="n">rotate_fernet_key</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span>
</pre></div>
</div>
</div>
</div>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="scheduler.html" class="btn btn-neutral float-right" title="Scheduling &amp; Triggers" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="profiling.html" class="btn btn-neutral float-left" title="Data Profiling" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>