Snowflake CLI release notes for 2025¶
This article contains the release notes for the Snowflake CLI, including the following when applicable:
Behavior changes
New features
Customer-facing bug fixes
See Snowflake CLI for documentation.
Version 3.12.0 (Sep 24, 2025)¶
New features and updates¶
Added the
!editcommand to thesnow sqlcommand to support external editors.Added the
--partialoption to thesnow logscommand to support partial, case-insensitive matching of log messages.Improved parsing
!sourcewith trailing comments.Upgraded to
typer=0.17.3to improve the display of help messages.Improved output handling with streaming queries in the
snow sqlcommand.
Bug fixes¶
Fixed crashes with older x86_64 Intel CPUs.
Fixed the
!commands insnow sqlcommands so they no longer require a trailing;for evaluation.Fixed using
ctx.varinsnow sqlwith Jinja templating.Fixed issues when pasting content with trailing new lines.
Fixed an issue with
snow snowpark deployfailing on duplicated packages.Fixed an issue causing a
snow spcs logsIndexOutOfRangeerror.
Version 3.11.0 (Aug 25, 2025)¶
New features and updates¶
Added the
snow connection removecommand.Added support for the
runtime_environment_versionfield in notebook entity configurations to let you specify runtime environment version for containerized notebooks.Added the
snow auth oidccommands for managing workload identity federation authentication:snow auth oidc read-tokento read and display OIDC tokens from CI/CD environments.
Also included GitHub Actions provider support in these commands for password-less authentication in CI/CD pipelines.
Bug fixes¶
None.
Version 3.10.1 (Aug 15, 2025)¶
New features and updates¶
None
Bug fixes¶
Fixed
snow dbt deploycommand to properly handle fully qualified names.Fixed
snow dbt deploycommand to properly handle local directories with dots in names.
Version 3.10.0 (July 17, 2025)¶
Deprecations¶
This version deprecates the Snowpark processor in the Snowflake Native App Framework.
New features and updates¶
Added support for passing an OAuth token with the
--tokenoption.Added the ability to suppress new Snowflake CLI version messages.
Added the following new
--formatoptions for outputting data:CSV, which formats query output as CSV.JSON_EXT, which outputs JSON as JSON objects instead of strings.
Added the
--enabled_templatingoption for thesnow sqlcommand that lets you specify which of the following templates to use when resolving variables:Standard (
<% ... %>), enabled by default.Legacy (
&{ ... }), enabled by default.Jinja (
{{ ... }}), disabled by default.
Added a
packagesalias forartifact_repository_packagesin thesnowflake.ymlschema.Added the
snow stage copy @src_stage @dst_stagecommand for copying files directly between two named stages.Added support for the DBT
deploy,execute, andlistcommands.
Bug fixes¶
Fixed an issue where the
snow sqlcommand would fail whensnowflake.ymlis invalid and the query has no templating.Fixed an issue with JSON serialzation for the
Decimal,time, andbinarydata types.
Version 3.9.1 (June 09, 2025)¶
New features and updates¶
Added the
--private-linkoption tosnow spcs image-registry logincommand to log in using private link URLs.
Bug fixes¶
None.
Version 3.9.0 (May 29, 2025)¶
New features and updates¶
Added the
--encryptionoption to thesnow stage createcommand to define the type of encryption to use for all files on the stage.
Bug fixes¶
Fixed errors that occurred for
usecommands if the current database is not set.
Version 3.8.3 (May 22, 2025)¶
New features and updates¶
None
Bug fixes¶
Added the
--private-linkoption to thesnow spcs image-registry urlcommand for retrieving private link URLs.
Version 3.8.2 (May 21, 2025)¶
New features and updates¶
None
Bug fixes¶
Changed the
enable_release_channelsproperty default fromFalseto None.
Version 3.8.1 (May 20, 2025)¶
New features and updates¶
None
Bug fixes¶
The upgrade message is now sent to
stderr.Fixed a
snowflake.coreimport issue on newer Python versions.
Version 3.8.0 (May 16, 2025)¶
New features and updates¶
Added support for OAuth tokens.
Added the following enhancements to the
snow sqlcommand:Added an interactive mode.
Added support for asynchronous SQL queries.
Added support for the
!queries,!result, and!abortSQL query commands.Added the
--single-transactioncommand line option to execute multiple SQL queries as an all-or-nothing batch, ensuring that all commands complete successfully before any of the changes are committed.Added the
artifact_repositoryfield to the Snowpark Entity Model to support using non-anaconda packages.
Bug fixes¶
Fixed an issue with deploying Snowpark project using the
!=operator inrequirements.txt.Fixed an issue with escaping identifiers for
usecommands.Moved the
enable_release_channelsparameter from the global level to the project level.Fixed the
snow spcs service metricscommand to accept fully qualified service names.
Version 3.7.2 (May 12, 2025)¶
New features and updates¶
None.
Bug fixes¶
Fixed an issue with errors appearing in help messages.
Version 3.7.1 (April 28, 2025)¶
New features and updates¶
None.
Bug fixes¶
Fixed certificate connection issues.
Fixed a
snow spcs image-registrylogin slow query problem.
Version 3.7.0 (April 16, 2025)¶
New features and updates¶
Added the
--pruneoption to thesnow notebook deploy,snow snowpark deploy, andsnow streamlit deploycommands that removes files that exist in the stage, but not in the local filesystem.Added the
snow logscommand for retrieving and streaming logs from the server.Added the
snow helper check-snowsql-env-varsthat reports environment variables from SnowSQL with their Snowflake CLI replacements.
Bug fixes¶
Updated the MacOS post-install script to update the
PATHenvironment variable, if needed, to ensure thesnowcommand is available.
Version 3.6.0 (April 2, 2025)¶
New features and updates¶
Added support for the
!sourcecommand in SQL queries to allow executing SQL from local files.
Bug fixes¶
Fixed an issue with incompatible options in
snow spcs compute-poolcommands that didn’t raise error.Changed binary builds to embed the whole Python environment.
Fixed recursive copying to a stage for unbalanced directory trees.
Fixed checking for a new Snowflake CLI version.
Added file execution logs in
snow stageandsnow gitcommands.
Version 3.5.0 (March 10, 2025)¶
New features and updates¶
Extended project definition (
snowflake.yml) support for the following SPCS (Snowpark Container Services) entities:Compute pool
Image repository
Service
Added the
snow spcs compute pool deploycommand that reads asnowflake.ymlproject definition file.Added the
snow spcs image repository deploycommand that reads asnowflake.ymlproject definition file.Added the
snow spcs service deploycommand that reads asnowflake.ymlproject definition file.
Bug fixes¶
Fixed an issue with data type handling in the
snow sqlcommand when using JSON for the output format.
Version 3.4.0 (February 13, 2025)¶
New features and updates¶
Added the optional
stage_subdirectoryfield to the application package entity. When this value is specified, application artifacts are uploaded to this subdirectory instead of to the root of the application package’s stage.Added the following
snow spcs servicecommands:snow spcs service eventsretrieves service-specific events.snow spcs service metricsfetches service metrics.
Added the following
snow app release-directivecommands:snow app release-directive add-accountsadds accounts to a release directive.snow app release-directive remove-accountsremoves accounts from a release directive.
Added the
snow app release-channel set-accountscommand to set accounts for release channels.Added the
--force-replaceoption to thesnow snowpark deploycommand to replace entities even if no changes are detected.Added the following notebook functionality:
Added the
snow notebook deploycommand that allows the creation of a notebook using a local file.Added support for containerized notebooks.
Added
notebookto the supported object types for thesnow objectcommands.
Added support for glob patterns (except
**)in artifacts paths in Streamlit and Snowparksnowflake.yymlfiles.Note
Using glob patterns in Snowpark
snowflake.ymlfiles requires enabling the ENABLE_SNOWPARK_GLOB_SUPPORT feature flag.Added support for the Mac OS x86_64 architecture.
Bug fixes¶
Fixed an MFA caching issue in the Snowflake CLI binary installation files.
Fixed an auto-completion issue in the Snowflake CLI binary installation files.
Version 3.3.0 (January 21, 2025)¶
Note
On January 28, 2025, Snowflake updated the documentation for the snow add release channel commands to indicate that the feature is in Public Preview instead of General Availability.
New features and updates¶
Added the following Snowflake Native Apps features and updates:
Added the following commands to support release directives:
snow app release-directive listsnow app release-directive setsnow app release-directive unset
Added support for release channels, including the following:
Added support release channels in the
snow app version createandsnow app version dropcommands.Added the ability to specify a release channel when creating an application instance from a release directive (
snow app run --from-release-directive --channel=<channel>).Added the
snow app release-channel listto list available release channels.Added the
now app release-channel add-accountsandsnow app release-channel remove-accountscommands to support adding and removing accounts from release channels.Added the
snow app release-channel add-versionandsnow app release-channel remove-versioncommands to add versions to and remove versions from release channels.
Added the
snow app publishcommand to simplify publishing versions to release channels and to update release directives.Made the following changes to the
snow app version createcommand:The command now returns the version, patch, and label in JSON format.
Added the
--from-stageoption to allow version creation from the content of a stage without needing to re-synchronize to the stage.
Added the
snow helpers import-snowsql-connectionscommand to import connections from existing SnowSQL configurations.Added support for restricting user access to Snowflake CLI only. For more information, see Add an authentication policy that limits access to Snowflake CLI only.
Bug fixes¶
Fixed the inability to add patches to lowercase quoted versions.
Fixed an issue with setting label to blank instead of
Nonewhen not provided.Fixed the
snow connection generate-jwtcommand to preserve command line connection options.Fixed stage path handling for notebook commands.