2025 年 Snowflake Python APIs 版本说明¶

新功能和更新¶

• 增加了对以下方法的支持，用于在使用 Time Travel 创建流时指定时间点参考：

  • PointOfTimeStatement

  • PointOfTimeStream

  • PointOfTimeTimestamp

错误修复¶

• 修复了警告：'allow_population_by_field_name' has been renamed to 'validate_by_name'。

• 恢复了在删除终结器任务之前 drop_finalizer 必须设置为 True 的 DAGOperation 的 drop 方法行为。

  由于 9.20 Snowflake 版本的变更，fetch_task_dependents 开始返回终结器任务以及属于有向无环图 (DAG) 的其他任务。这种行为导致 drop 方法总是丢弃终结器。

新功能和更新¶

• 为 Cortex Search Service API 的 QueryRequest 中 query 和 column 参数进行了可选设置。

错误修复¶

无。

新功能和更新¶

无。

错误修复¶

• 修复了 ProcedureResource 中的一个错误，该错误导致 call 方法在使用带有 ReturnTable 类型的 extract 选项时返回错误的结果。

• 现在可以从 Python 工作表和笔记本中调用 CortexInferenceService.complete。

新功能和更新¶

• 弃用了 ServiceResource.get_service_status 方法，并以 ServiceResource.get_containers 取而代之

• 为 procedure.call 方法添加了 extract 选项。启用此选项会使该方法从返回的有效负载中提取结果。

  例如，设置 extract=False``（当前默认行为）会返回一个结果，如 ``[{'procedure_name': 42}]。在此示例中，您可以将 extract=True 设置为返回值 42。

  备注

  extract=False 仍然是当前的默认设置，但现在会返回弃用警告。建议改为使用 extract=True，这将成为下一个主要版本中的新默认设置。

• 增加了对在存储过程调用中映射 VARIANT 类型的支持。

错误修复¶

• 修复了存储过程中 GEOMETRY、GEOGRAPHY、OBJECT 返回类型的类型映射。

• 现在，存储过程和函数的 __repr__ 实现不但会显示名称，还会显示实参列表。

新功能和更新¶

• 为所有集合、资源和模型类实现了 __repr__ 方法。

错误修复¶

• 将 _SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE 环境变量更改为默认启用，这会导致输出的错误消息显示完整的堆栈跟踪。

  此更改旨在避免对所有异常禁用堆栈跟踪，当未设置 SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE 时，就会发生这种情况。

新功能和更新¶

• 添加了代表对象标识符的 snowflake.core.FQN 类。

• 如果 drop_finalizer 实参设置为 True，则 DAGOperation.drop 方法会删除与 DAG 关联的终结器任务。

  重要

  drop_finalizer 实参将在下一个主要 API 版本中移除，并且 DAGOperation.drop 方法将始终删除关联的终结器任务以及 DAG。

错误修复¶

无。

新功能和更新¶

• 添加了对所有现有端点的异步请求的支持。

  异步方法由其名称中的 _async 后缀表明，并使用轮询来确定操作是否已完成。

  可并行执行的调用数量取决于 CPUs 的数量。要更改线程池的大小，请使用 _SNOWFLAKE_MAX_THREADS 环境变量。

  有关用法示例，请参阅 `snowflake.core.PollingOperation</developer-guide/snowflake-python-api/reference/latest/_autosummary/snowflake.core.PollingOperation>`_ 类文档。

• 添加了对使用 StoredProcedureCall 定义创建 Serverless Task 的支持。

• 添加了对 Database 和 Schema 资源的 SERVERLESS_TASK_MIN_STATEMENT_SIZE 和 SERVERLESS_TASK_MAX_STATEMENT_SIZE 无服务器属性的支持（依赖于 Snowflake 版本 9.8）。

• 添加了对于在克隆的数据库和架构上设置 SUSPEND_TASK_AFTER_NUM_FAILURES、USER_TASK_MANAGED_INITIAL_WAREHOUSE_SIZE 和 USER_TASK_TIMEOUT_MS 属性的支持（依赖于 Snowflake 版本 9.8）。

• 弃用了 CortexAgentService.Run，以 CortexAgentService.run 取而代之。

• 为 Cortex Search 服务 API 中的各种模型添加了新的可选属性：

  • 为 Function 模型添加了 text_boosts 和 vector_boosts

  • 为 ScoringConfig 模型添加了 weights

错误修复¶

• 您现在可以调用 create_or_alter，并使用 iter 方法返回的任务对象。

新功能和更新¶

• 为任务资源添加了对 TARGET_COMPLETION_INTERVAL、SERVERLESS_TASK_MIN_STATEMENT_SIZE 和 SERVERLESS_TASK_MAX_STATEMENT_SIZE 无服务器属性的支持。

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

  • API 集成

  • Iceberg 表（依赖于 Snowflake 版本 9.6）

错误修复¶

无。

新功能和更新¶

• 从 snowflake.core 移除了 protobuf 依赖项。

错误修复¶

无。

新功能和更新¶

• 添加了对 Cortex Lite Agent 资源的支持。

错误修复¶

无。

新功能和更新¶

• 添加了对 Cortex Embed 资源的支持。

错误修复¶

无。