2024 年 Snowflake Python APIs 版本说明¶

新功能和更新¶

• 在 Service 资源的 execute_job API 中移除了 async_req 参数（异步模式）。

错误修复¶

• 无。

新功能和更新¶

• 添加了对以下新资源的支持：

  • Cortex Chat

  • Cortex 推理

• 添加了对定制用户代理的支持。

错误修复¶

• 修复了 Enum 类型的 ValueError 消息。

• 修复了 Enum 类型的 API 文档来显示可能的值。

• 将缺失的 DeleteMode 类型添加至 API 文档。

新功能和更新¶

• 通过缩短堆栈跟踪来改进错误消息。要控制此行为，请使用 _SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE 环境变量选项。

• 现在，模型中的 to_dict() 返回的字典中默认包含只读属性。要切换此选项，请使用 to_dict (hide_readonly_properties=True)。

• 以下方法和资源中添加了 if_exists 属性，该属性可在给定资源不存在的情况下，切换是否可以执行操作而不是报错：

  • Database、NetworkPolicy、View、User、ComputePool、ImageRepository、Pipe、Role、Service、Stage、Table、Task、DynamicTable、Role、Alert、Procedure、Warehouse、Schema 和 Function 的 drop()。

  • Database 和 DynamicTable 的 refresh()。

  • Service、DynamicTable 和 Warehouse 的 suspend() 和 resume()。

  • DynamicTable 和 Table 的 suspendRecluster() 和 resumeRecluster()。

• Database 现在支持 undrop() 方法。

• Service 现在支持 iter() 中的 from_name 参数 。

• Table 现在支持 swap_with() 中的 target_database 和 target_schema 参数。

• Procedure 现在支持 create() 中的 copy_grants 参数 。

错误修复¶

• 现在，创建动态表时可以正确地从不同数据库和架构中克隆源对象。

• 修复了当主机名中包含下划线时，账户和组织遇到的 SSL 连接问题。

新功能和更新¶

• 添加了对数据库角色资源的支持。

• 为角色、数据库角色和用户资源添加了新方法来管理访问权限。

• 改进了日志，清除了密钥。

错误修复¶

• 无。

新功能和更新¶

• 显著改进了 API 文档。

• 移除了 snowflake.core 的依赖项 snowflake-snowpark-python。但是，某些功能仍需要此包，例如任务图 (DAG) 概念；这些功能的检查和要求是在运行时进行。

• 添加了对所有 Python 3.8 版本或更高版本的支持。

• 添加了克隆表所需的对 targetDatabase 和 targetSchema 的支持。

• 添加了克隆架构所需的对 targetDatabase 的支持。

• 公开了类型定义。

• 在 ServiceCollection 中添加了对 execute_job 的支持。

• 在 ServiceResource 中添加了对 get_containers、get_instances 和 get_roles 的支持。

• 在 Service 和 ComputePool 中添加了对 create_or_update 的支持。

• 添加了对以下新资源的支持：

  • 账户

  • 警报

  • 目录集成

  • 事件表

  • 外部卷

  • 托管账户

  • 网络策略

  • 笔记本

  • 通知集成

  • 管道

  • 过程

  • 流

  • 用户定义的函数

  • 视图

错误修复¶

• 修复了与 URLs 日志记录相关的错误，其中并非所有 URL 部分均注入日志。

新功能和更新¶

• 无。

错误修复¶

• 修复了与处理大量结果相关的多个问题。

新功能和更新¶

• 客户端现在可以对可重试的错误代码重试请求。

• 下列 StageResource 方法现已弃用并重命名。现在，旧的方法名称是别名。

  • 从 upload_file 到 put。

  • 从 download_file 到 get。

新功能和更新¶

• 向库中添加客户端日志记录功能以增强调试能力。

• 向 DynamicTable、Schema 和 Table 对象类型添加了 undrop 支持。

• 对具有以下限制的 Grant 对象类型增强了支持：

  • 不支持 SQL 命令 SHOW GRANTS ON。

  • 对于 Grants.to 方法 (SHOW GRANTS TO)，仅支持 Grantees.role 作为被授权方的值。

• 为了与对应的 SQL 命令更加一致，以下方法现已弃用，并已做出如下重命名。旧方法名称现在是调用新方法名称的别名，因此旧方法名称仍将如预期一样有效。

  • 从 create_or_update 到 create_or_alter。

  • 从 delete 到 drop。

  • 从 undelete 到 undrop。

错误修复¶

• 修复了存储过程生成代码中的一个错误。

新功能和更新¶

• 添加了对以下资源的 API 支持：

  • DynamicTable

  • :code:`Function`（目前仅支持服务功能）

  • Grant

• 添加了对任务和任务图中终结器的支持 (DAGs)。

新功能和更新¶

• 在 实验 模式下为以下资源添加了 API 支持：

  • User

  • Role

  • 管理 Stage

• 重新为 Warehouse、Schema 和 Database 资源添加了 create_or_update 支持。

  备注

  这些资源的 create_or_update 功能需要即将发布的 Snowflake 版本 8.23，截至 2024 年 6 月 10 日该版本目前尚未发布。

• 为 Service 资源添加了 get_endpoints 方法，可以为给定 Service 对象返回端点列表。

错误修复¶

• with_managed_access 现已作为 SchemaResource 的属性正确返回。

新功能和更新¶

• 在 create_or_update 中为 SchemaResource 添加了 with_managed_access 布尔选项。此选项相当于 CREATE SCHEMA 中的 WITH MANAGED ACCESS 可选参数。

  • 使用示例：

    schema.create_or_update(schema_def, with_managed_access = True)
    

    Copy

• 为 Service 资源添加了 get_endpoints 方法，可以为给定 Service 对象返回端点列表。

行为变更¶

• 从 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 时会引发错误。