本地最新snowflake-snowpark-python 1.6.1与Snowflake服务端版本不兼容问题

核心事实 #

Snowflake服务端预安装的snowflake-snowpark-python版本由官方统一管控，普通用户无权限自行更新服务端的包版本。官方会依据版本稳定性、兼容性分区域逐步推送更新。

可行解决方案 #

• 降级本地开发版本
  将本地虚拟环境的包版本对齐服务端的1.5.1，彻底避免版本差异导致的API兼容问题：

  pip install snowflake-snowpark-python==1.5.1
  

  此方法最简单直接，能保证本地开发与服务端运行环境完全匹配。

• 自定义上传依赖包（需用新版本功能时）
  若必须使用1.6.1的特定函数，可通过自定义依赖包上传的方式，让存储过程/UDF使用你指定的版本：

  1. 下载snowflake-snowpark-python==1.6.1的wheel包到本地
  2. 创建Snowflake内部阶段用于存储包：

     CREATE OR REPLACE STAGE my_custom_packages;
     

  3. 上传wheel包到阶段：

     PUT file:///本地路径/snowflake_snowpark_python-1.6.1-py3-none-any.whl @my_custom_packages AUTO_COMPRESS = FALSE;
     

  4. 创建存储过程时指定自定义包：

     CREATE OR REPLACE PROCEDURE your_procedure_name()
     RETURNS STRING
     LANGUAGE PYTHON
     RUNTIME_VERSION = 3.9
     PACKAGES = ('@my_custom_packages/snowflake_snowpark_python-1.6.1-py3-none-any.whl')
     HANDLER = 'your_function_handler'
     AS $$
     # 你的存储过程代码逻辑
     $$;
     

  注意：需确保包版本与Snowflake指定的Python运行时版本兼容，且后续需自行维护包的更新。

• 向官方提交更新请求
  若业务依赖新版本功能，可通过Snowflake官方支持渠道提交版本更新申请，推动官方尽快将1.6.1版本推送到你的部署区域。

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