Snowflake Python APIs release notes for 2025¶

New features and updates¶

• Added support for proxy configuration. You can provide proxy settings by using the HTTPS_PROXY environment variable.

Bug fixes¶

None.

New features and updates¶

• Added support to the following methods for specifying the point-of-time reference when you use Time Travel to create streams:

  • PointOfTimeStatement

  • PointOfTimeStream

  • PointOfTimeTimestamp

Bug fixes¶

• Fixed a warning: 'allow_population_by_field_name' has been renamed to 'validate_by_name'.

• Restored the behavior of the drop method of DAGOperation such that drop_finalizer must be set to True before the finalizer task is dropped.

  As a result of changes in the 9.20 Snowflake release, fetch_task_dependents started returning the finalizer task alongside other tasks that belong to the Directed Acyclic Graph (DAG). This behavior caused the drop method to always drop the finalizer.

New features and updates¶

• Optionalized the query and column parameters in QueryRequest for the Cortex Search service API.

Bug fixes¶

None.

New features and updates¶

None.

Bug fixes¶

• Fixed a bug in ProcedureResource that caused the call method to return wrong results when using the extract option with the ReturnTable type.

• CortexInferenceService.complete can now be called from Python worksheets and notebooks.

New features and updates¶

• Deprecated the ServiceResource.get_service_status method in favor of the ServiceResource.get_containers method.

• Added the extract option to the procedure.call method. Enabling this option causes the method to extract results from the returned payload.

  For example, setting extract=False (current default behavior) returns a result such as [{'procedure_name': 42}]. In this example, you can set extract=True to return the value 42.

  Note

  extract=False remains the current default setting but now returns a deprecation warning. The recommendation is to switch to using extract=True, which will become the new default in the next major release.

• Added support for mapping the VARIANT type in a stored procedure call.

Bug fixes¶

• Fixed the type mapping for the GEOMETRY, GEOGRAPHY, OBJECT return types in stored procedures.

• The __repr__ implementation for stored procedures and functions now shows a list of arguments in addition to the name.

New features and updates¶

• Implemented the __repr__ method for all collection, resource, and model classes.

Bug fixes¶

• Changed the _SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE environment variable to be enabled by default, which causes printed error messages to display the full stack trace.

  This change was made to avoid disabling stack traces for all exceptions, which happens when SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE is not set.

New features and updates¶

• Added the snowflake.core.FQN class, which represents an object identifier.

• The DAGOperation.drop method drops the finalizer task associated with the DAG if the drop_finalizer argument is set to True.

  Important

  The drop_finalizer argument will be removed in the next major API release, and the DAGOperation.drop method will always drop the associated finalizer task along with the DAG.

Bug fixes¶

None.

New features and updates¶

• Added support for asynchronous requests across all of the existing endpoints.

  Asynchronous methods are denoted by the _async suffix in their names and use polling to determine whether an operation was completed.

  The number of calls that can execute in parallel depends on the number of CPUs. To change the size of the thread pool, use the _SNOWFLAKE_MAX_THREADS environment variable.

  For example usage, see the snowflake.core.PollingOperation class documentation.

• Added support for creating serverless tasks using the StoredProcedureCall definition.

• Added support for the SERVERLESS_TASK_MIN_STATEMENT_SIZE and SERVERLESS_TASK_MAX_STATEMENT_SIZE serverless attributes to the Database and Schema resources (dependent on Snowflake version 9.8).

• Added support for setting the SUSPEND_TASK_AFTER_NUM_FAILURES, USER_TASK_MANAGED_INITIAL_WAREHOUSE_SIZE, and USER_TASK_TIMEOUT_MS attributes on cloned databases and schemas (dependent on Snowflake version 9.8).

• Deprecated CortexAgentService.Run in favor of CortexAgentService.run.

• Added new optional attributes to various models within the Cortex Search service API:

  • text_boosts and vector_boosts to the Function model

  • weights to the ScoringConfig model

Bug fixes¶

• You can now call create_or_alter with a task object returned from the iter method.

New features and updates¶

• Added support for the TARGET_COMPLETION_INTERVAL, SERVERLESS_TASK_MIN_STATEMENT_SIZE, and SERVERLESS_TASK_MAX_STATEMENT_SIZE serverless attributes to the Task resource.

• Added support for the following new resources:

  • API integrations

  • Iceberg tables (dependent on Snowflake version 9.6)

Bug fixes¶

None.

New features and updates¶

• Removed the protobuf dependency from snowflake.core.

Bug fixes¶

None.

New features and updates¶

• Added support for the Cortex Lite Agent resource.

Bug fixes¶

None.

New features and updates¶

• Added support for the Cortex Embed resource.

Bug fixes¶

None.