Airflow Summit 2025 将于 10 月 07 日至 09 日举行。立即注册获取早鸟票!

管理变量

变量是 Airflow 中一种通用的存储和检索任意内容或设置的方式,作为简单的键值存储。可以在 UI (Admin -> Variables)、代码或 CLI 中列出、创建、更新和删除变量。

../_images/variable_hidden.png

有关更多信息,请参阅变量概念文档。

在环境变量中存储变量

在版本 1.10.10 中添加。

Airflow 变量也可以使用环境变量创建和管理。环境变量命名约定是 AIRFLOW_VAR_{VARIABLE_NAME},全部大写。因此,如果您的变量键是 foo,则变量名应为 AIRFLOW_VAR_FOO

例如,

export AIRFLOW_VAR_FOO=BAR

# To use JSON, store them as JSON strings
export AIRFLOW_VAR_FOO_BAZ='{"hello":"world"}'

您可以在 DAG 中使用它们,如下所示:

from airflow.sdk import Variable

foo = Variable.get("foo")
foo_json = Variable.get("foo_baz", deserialize_json=True)

注意

单个下划线围绕 VAR。这与存储 airflow.cfg 参数的方式形成对比,后者使用双下划线围绕配置节名称。使用环境变量设置的变量不会出现在 Airflow UI 中,但您可以在 DAG 文件中使用它们。使用环境变量设置的变量也将优先于 Airflow UI 中定义的变量。

保护变量安全

Airflow 使用 Fernet 对存储在元数据数据库中的变量进行加密。它保证在没有加密密码的情况下,内容无法被篡改或读取。有关配置 Fernet 的信息,请参阅Fernet

除了从环境变量或元数据数据库检索变量外,您还可以启用秘密后端来检索变量。有关更多详细信息,请参阅秘密后端

此条目有帮助吗?