Snowflake Python APIs release notes for 2025

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

  • Behavior changes

  • New features

  • Customer-facing bug fixes

See Snowflake Python APIs: Managing Snowflake objects with Python for documentation.

Version 1.4.0 (April 23, 2025)

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.

Version 1.3.0 (April 9, 2025)

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.

Version 1.2.0 (March 26, 2025)

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.

Version 1.1.0 (March 12, 2025)

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.

Version 1.0.5 (February 19, 2025)

New features and updates

  • Removed the protobuf dependency from snowflake.core.

Bug fixes

None.

Version 1.0.4 (February 13, 2025)

New features and updates

  • Added support for the Cortex Lite Agent resource.

Bug fixes

None.

Version 1.0.3 (February 4, 2025)

New features and updates

  • Added support for the Cortex Embed resource.

Bug fixes

None.