Lambda函数中Snowflake SQLAlchemy导入问题及版本适配咨询

版本搭配建议 #

snowflake-sqlalchemy 本身已包含 snowflake-connector-python 的兼容依赖，无需单独安装后者，这是避免冲突的核心。推荐以下稳定版本组合：

• 适配 SQLAlchemy 1.4.x（兼容性最广）：sqlalchemy==1.4.49 + snowflake-sqlalchemy==1.4.7
• 适配 SQLAlchemy 2.0+：sqlalchemy>=2.0.0 + snowflake-sqlalchemy>=1.5.0

解决步骤 #

1. 清理冲突依赖，重新安装
   先卸载所有相关包，彻底消除版本冲突：

   pip uninstall -y sqlalchemy snowflake-connector-python snowflake-sqlalchemy
   

   仅安装 snowflake-sqlalchemy，它会自动拉取兼容的 SQLAlchemy 和 connector 版本：

   pip install snowflake-sqlalchemy
   

   如需锁定版本，使用指定版本安装：

   pip install snowflake-sqlalchemy==1.4.7 sqlalchemy==1.4.49
   

2. 正确的导入与使用方式
   无需单独导入 snowflake.connector，只需要导入 SQLAlchemy 和 snowflake-sqlalchemy 的 URL 工具即可：

   from sqlalchemy import create_engine
   from snowflake.sqlalchemy import URL
   
   # 构建连接引擎
   engine = create_engine(URL(
       account="your_account_id",
       user="your_username",
       password="your_password",
       database="your_db",
       schema="your_schema",
       warehouse="your_warehouse",
       role="your_role"
   ))
   
   # 测试连接
   with engine.connect() as conn:
       result = conn.execute("SELECT CURRENT_VERSION()")
       print(result.fetchone())
   

3. 对齐本地与部署环境
   本地运行正常但部署报错，大概率是环境依赖不一致：

   • 检查本地与部署环境的 Python 版本（比如本地 3.8、部署 3.10 可能存在兼容问题）
   • 用 requirements.txt 锁定所有依赖版本，部署时直接安装：

     sqlalchemy==1.4.49
     snowflake-sqlalchemy==1.4.7
     

     执行安装：pip install -r requirements.txt

常见坑点 #

• 禁止同时手动安装 snowflake-connector-python 和 snowflake-sqlalchemy，前者是后者的依赖，手动安装会导致版本冲突
• 部署环境如果使用虚拟环境，务必激活对应环境后再安装依赖
• 若使用 SQLAlchemy 2.0+，必须搭配 1.5.0 及以上版本的 snowflake-sqlalchemy，否则会出现 dialect 识别失败问题

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