Windows环境下Airflow配置Snowflake元数据库报错求助

1. 确认Airflow与Python版本兼容性 #

Python 3.12仅支持Airflow 2.8.0及以上版本，先检查当前Airflow版本：

pip show apache-airflow

如果版本低于2.8.0，可选择升级Airflow：

pip install --upgrade apache-airflow>=2.8.0

或降级Python至3.11（Airflow长期支持版本推荐搭配版本）。

2. 修复Airflow配置文件生成方式 #

手动复制config_templates目录下的airflow.cfg会导致默认参数缺失或路径错误，正确流程：

• 激活虚拟环境后，设置Airflow主目录环境变量（Windows命令行）：

set AIRFLOW_HOME=C:\your\custom\airflow\path

• 执行初始化命令自动生成配置文件与数据库：

airflow db init

之后再修改生成的airflow.cfg配置Snowflake连接信息。

3. 解决KeyError: 'snowflake' #

该错误是因为未安装Snowflake的Airflow Provider包，需在激活的虚拟环境内执行安装：

pip install apache-airflow-providers-snowflake

若Airflow版本为2.8.x，建议安装>=4.0.0版本的provider，避免版本不匹配问题。

4. 修复LOG表不存在/权限问题 #

• 删除AIRFLOW_HOME目录下可能损坏的airflow.db文件；
• 重新执行初始化与迁移命令：

airflow db init
airflow db migrate

• 检查airflow.cfg中的sql_alchemy_conn配置，确保路径正确且当前用户拥有该路径的读写权限，默认配置示例：

sql_alchemy_conn = sqlite:////C:/your/custom/airflow/path/airflow.db

5. 确认虚拟环境隔离有效性 #

• 执行where python（Windows），确认输出路径为虚拟环境内的Python.exe；
• 执行pip list，确认apache-airflow和apache-airflow-providers-snowflake均在虚拟环境的包列表中。

内容的提问来源于stack exchange，提问作者vital_parsley