Snowflake Python APIs release notes for 2025¶

This article contains the release notes for the Snowflake Python APIs, including the following when applicable:

Version 1.5.1 (May 28, 2025)¶

None.

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.

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.

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.

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

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.

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.

None.

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

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

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)

None.

None.

None.

None.