2024 年 Snowflake API for Python 版本说明¶

行为变更¶

• 从 TableResource 对象的 fetch() 中移除了 deep 参数。fetch() 始终返回 TableResource 的详细列和约束信息。

• create_or_update() 目前不再适用于 Schema、Warehouse、Database 和 ComputePool 资源。create() 适用于这些资源。

• 使用 as_select 创建表时，不再从用于 as_select 查询的源表中延续信息。

• 当未在更改现有表的 create_or_update 语句中显示设置时，表的 data_retention_time_in_days 和 max_data_extension_time_in_days 属性继承自架构或数据库设置。

新功能和更新¶

• 添加了对 Cortex Search API 端点的支持。

• 添加了对大型结果的支持。

• 添加了对长时间运行的查询的支持。

• 添加了 ServiceSpec helper 函数，用于从 Service 资源中提供的字符串来推断规范类型。

• 已更新为对所有资源使用 Snowflake API REST 平台。

• pip install snowflake[ml] 安装 snowflake-ml-python 1.4.0 版本。

错误修复¶

• 修复了多个错误。

新功能和更新¶

snowflake 包更新：

• 您现在可以运行 pip install snowflake[ml] 来安装 Snowpark ML (https://pypi.org/project/snowflake-ml-python/) 库，作为额外的包依赖项。

snowflake.core 包更新：

• 前置任务现在返回其完全限定名称。

• 向 DAGRun 添加了 __str__() 和 __repr_html__() 方法，使其与 Notebook 兼容。

• 已将 API 参考文档中的“DAGs”替换为“任务图”，以更好地与 Snowflake 文档保持一致。

错误修复¶

snowflake.core 包修复：

• 修复了代码生成器，并更新了 OpenAPI 规范驱动模型。

• 修复了 Pydantic 兼容性问题。

• 修复了 Task.error_integration 属性中的错误。

• 修复了当缺少 REST 属性时，Task.config 属性中的错误。

新功能和更新¶

• DAGTask 的 >> 和 << 运算符现可直接接受函数。

• DAGTask 现在默认使用 DAG 的仓库。

• DAGTask 接受新参数 session_parameters。

• 更新了 TaskContext:

  • 方法 get_predecessor_return_value 现在同时适用于 DAGTask 的长名称和短名称。

  • 添加了方法 get_current_task_short_name 和 get_task_graph_config_property。

• 添加了对 pydantic 2.x 的支持。

• 添加了对 Python 3.11 的支持。

错误修复¶

• 修复了以下错误：如果 DAG 没有计划，则 DAGOperation.run() 引发异常。

• 修复了以下错误：删除 DAG 并不能删除其所有子任务。

• 修复了以下错误：当设置了 DAG 的 config 时会引发错误。