Notas de lançamento de Snowflake CLI para 2025¶
Este artigo contém as notas de versão do Snowflake CLI, incluindo o seguinte, quando aplicável:
Mudanças de comportamento
Novos recursos
Correções de bugs voltados para o cliente
Consulte Snowflake CLI para ver a documentação.
Versão 3.11.0 (25 de agosto de 2025)¶
Novos recursos e atualizações¶
Adição do comando
snow connection remove.Adição de suporte para o campo
runtime_environment_versionnas configurações da entidade do notebook para permitir que você especifique a versão do ambiente de tempo de execução para notebooks em contêineres.Adição de comandos
snow auth oidcpara gerenciar a autenticação da federação de identidade da carga de trabalho:snow auth oidc read-tokenpara ler e exibir tokens OIDC de ambientes CI/CD.
Também incluído suporte do provedor de ações GitHub nestes comandos para autenticação sem senha em pipelines CI/CD.
Correções de bugs¶
Nenhum.
Versão 3.10.1 (15 de agosto de 2025)¶
Novos recursos e atualizações¶
Nenhum
Correções de bugs¶
Correção do comando
snow dbt deploypara manipular corretamente nomes totalmente qualificados.Correção do comando
snow dbt deploypara manipular corretamente diretórios locais com pontos em nomes.
Versão 3.10.0 (17 de julho de 2025)¶
Preterições¶
Esta versão descontinua o processador Snowpark no Snowflake Native App Framework.
Novos recursos e atualizações¶
Adição de suporte para passar um token OAuth com a opção
--token.Adição da capacidade de suprimir novas mensagens de versão do Snowflake CLI.
Adição das seguintes novas opções
--formatpara saída de dados:CSV, que formata a saída da consulta como CSV.JSON_EXT, que gera JSON como objetos JSON em vez de cadeias de caracteres.
Adição da opção
--enabled_templatesao comandosql snowque permite especificar quais dos seguintes modelos usar ao resolver variáveis:Padrão (
<% ... %>), ativado por padrão.Legado (
&{ ... }), ativado por padrão.Jinja (
{{ ... }}), desativado por padrão.
Adição de um alias
pacotesparaartifact_repository_packagesno esquemasnowflake.yml.Adição do comando
snow stage copy @src_stage @dst_stagepara copiar arquivos diretamente entre dois estágios nomeados.Adição de suporte para os comandos DBT
deploy,executeelist.
Correções de bugs¶
Correção de um problema em que o comando
snow sqlfalharia quandosnowflake.ymlé inválido e a consulta não possui modelo.Correção de um problema com a serialização de JSON para os tipos de dados
Decimal,timeebinary.
Versão 3.9.1 (09 de junho de 2025)¶
Novos recursos e atualizações¶
Adicionada a opção
--private-linkao comandosnow spcs image-registry loginpara fazer login usando URLs de link privado.
Correções de bugs¶
Nenhum.
Versão 3.9.0 (29 de maio de 2025)¶
Novos recursos e atualizações¶
Foi adicionada a opção
--encryptionao comandosnow stage createpara definir o tipo de criptografia a ser usado para todos os arquivos no estágio.
Correções de bugs¶
Corrigidos os erros que ocorriam nos comandos
usese o banco de dados atual não estiver definido.
Versão 3.8.3 (22 de maio de 2025)¶
Novos recursos e atualizações¶
Nenhum
Correções de bugs¶
Adicionada a opção
--private-linkao comandosnow spcs image-registry urlpara recuperar URLs de link privado.
Versão 3.8.2 (21 de maio de 2025)¶
Novos recursos e atualizações¶
Nenhum
Correções de bugs¶
Alterado o padrão da propriedade
enable_release_channelsdeFalsepara None.
Versão 3.8.1 (20 de maio de 2025)¶
Novos recursos e atualizações¶
Nenhum
Correções de bugs¶
A mensagem de atualização agora é enviada para
stderr.Corrigido um problema de importação
snowflake.coreem versões mais recentes do Python.
Versão 3.8.0 (16 de maio de 2025)¶
Novos recursos e atualizações¶
Foi adicionado suporte para tokens do OAuth.
Foram adicionadas as seguintes melhorias ao comando
snow sql:Foi adicionado um modo interativo.
Foi adicionado suporte a consultas SQL assíncronas.
Foi adicionado suporte aos comandos de consulta
! queries,! resulte! abortSQL.Foi adicionada a opção de linha de comando
--single-transactionpara executar várias consultas SQL como um lote do tipo tudo ou nada, garantindo que todos os comandos sejam concluídos com êxito antes que qualquer alteração seja confirmada.Adição de um campo
artifact_repositorypara o modelo de entidade do Snowpark para oferecer suporte ao uso de pacotes não Anaconda.
Correções de bugs¶
Corrigido um problema com a implementação do projeto Snowpark usando o operador
! =emrequirements.txt.Corrigido um problema com o escape de identificadores para comandos
use.Movido o parâmetro
enable_release_channelsdo nível global para o nível do projeto.Corrigido o comando
snow spcs service metricspara aceitar nomes de serviços totalmente qualificados.
Versão 3.7.2 (12 de maio de 2025)¶
Novos recursos e atualizações¶
Nenhum.
Correções de bugs¶
Corrigido um problema com a exibição de erros nas mensagens de ajuda.
Versão 3.7.1 (28 de abril de 2025)¶
Novos recursos e atualizações¶
Nenhum.
Correções de bugs¶
Correção de problemas de conexão de certificado.
Corrigido um problema de consulta lenta de login do
snow spcs image-registry.
Versão 3.7.0 (16 de abril de 2025)¶
Novos recursos e atualizações¶
Foi adicionada a opção
--pruneaos comandossnow notebook deploy,snow snowpark deployesnow streamlit deployque remove arquivos que existem no estágio, mas não no sistema de arquivos local.Foi adicionado o comando
snow logspara recuperar e transmitir logs do servidor.Adicionado o
snow helper check-snowsql-env-varsque relata variáveis de ambiente do SnowSQL com suas substituições de Snowflake CLI.
Correções de bugs¶
O script pós-instalação do MacOS foi atualizado para atualizar a variável de ambiente
PATH, se necessário, para garantir que o comandosnowesteja disponível.
Versão 3.6.0 (2 de abril de 2025)¶
Novos recursos e atualizações¶
Foi adicionado suporte para o comando
!sourceem consultas SQL para permitir a execução de SQL a partir de arquivos locais.
Correções de bugs¶
Corrigido um problema com opções incompatíveis nos comandos
snow spcs compute-poolque não geravam erro.Alterou as compilações binárias para incorporar todo o ambiente Python.
Correção da cópia recursiva em um estágio para árvores de diretórios desequilibradas.
Corrigida a verificação de uma nova versão do Snowflake CLI.
Foram adicionados logs de execução de arquivos nos comandos
snow stageesnow git.
Versão 3.5.0 (10 de março de 2025)¶
Novos recursos e atualizações¶
Suporte à definição de projeto estendido (
snowflake.yml) para as seguintes entidades de SPCS (Snowpark Container Services):Pool de computação
Repositório de imagens
Serviço
Foi adicionado o comando
snow spcs compute pool deployque lê um arquivo de definição de projetosnowflake.yml.Foi adicionado o comando
snow spcs image repository deployque lê um arquivo de definição de projetosnowflake.yml.Foi adicionado o comando
snow spcs service deployque lê um arquivo de definição de projetosnowflake.yml.
Correções de bugs¶
Corrigido um problema com o tratamento do tipo de dados no comando
snow sqlao usar JSON para o formato de saída.
Versão 3.4.0 (13 de fevereiro de 2025)¶
Novos recursos e atualizações¶
Foi adicionado o campo opcional
stage_subdirectoryà entidade do pacote de aplicativo. Quando esse valor é especificado, os artefatos do aplicativo são carregados nesse subdiretório em vez de na raiz do estágio do pacote de aplicativo.Foram adicionados os seguintes comandos
snow spcs service:snow spcs service eventsrecupera eventos específicos do serviço.snow spcs service metricsobtém métricas de serviço.
Foram adicionados os seguintes comandos
snow app release-directive:snow app release-directive add-accountsadiciona contas a uma diretriz de versão.snow app release-directive remove-accountsremove contas de uma diretriz de versão.
Adicionado o comando
snow app release-channel set-accountspara definir contas para canais de lançamento.Adicionada a opção
--force-replaceao comandosnow snowpark deploypara substituir entidades mesmo que nenhuma alteração seja detectada.Foi adicionada a seguinte funcionalidade de notebook:
Foi adicionado o comando
snow notebook deployque permite a criação de um notebook usando um arquivo local.Foi adicionado suporte a notebooks em contêineres.
Foi adicionado o
notebookaos tipos de objetos compatíveis para os comandossnow object.
Foi adicionado suporte a padrões glob (exceto
**)em caminhos de artefatos nos arquivos Streamlit e Snowparksnowflake.yyml.Nota
O uso de padrões glob em arquivos do Snowpark
snowflake.ymlrequer a ativação do sinalizador de recurso ENABLE_SNOWPARK_GLOB_SUPPORT.Foi adicionado suporte para a arquitetura Mac OS x86_64.
Correções de bugs¶
Foi corrigido um problema de cache do MFA nos arquivos de instalação binários do Snowflake CLI.
Foi corrigido um problema de preenchimento automático nos arquivos de instalação binários do Snowflake CLI.
Versão 3.3.0 (21 de janeiro de 2025)¶
Nota
Em 28 de janeiro de 2025, o Snowflake atualizou a documentação dos comandos snow add release channel para indicar que o recurso está em Versão preliminar pública em vez de Disponibilidade geral.
Novos recursos e atualizações¶
Adição dos seguintes recursos e atualizações do Snowflake Native Apps:
Foram adicionados os seguintes comandos para dar suporte às diretivas do lançamento:
snow app release-directive listsnow app release-directive setsnow app release-directive unset
Adição de suporte para canais de lançamento, incluindo o seguinte:
Adição de suporte a canais de lançamento nos comandos
snow app version createesnow app version drop.Adição da capacidade de especificar um canal de lançamento ao criar uma instância de aplicativo a partir de uma diretiva de lançamento (
snow app run --from-release-directive --channel=<channel>).Adição do
snow app release-channel listpara listar os canais de lançamento disponíveis.Foram adicionados os comandos
now app release-channel add-accountsesnow app release-channel remove-accountspara dar suporte à adição e remoção de contas dos canais de lançamento.Adição dos comandos
snow app release-channel add-versionesnow app release-channel remove-versionpara adicionar versões e remover versões de canais de lançamento.
Adição do comando
snow app publishpara simplificar a publicação de versões em canais de lançamento e para atualizar as diretivas de lançamento.Feitas as seguintes alterações no comando
snow app version create:O comando agora retorna a versão, o patch e o rótulo no formato JSON.
Adição da opção
--from-stagepara permitir a criação de versões a partir do conteúdo de um estágio sem a necessidade de ressincronização com o estágio.
Adição do comando
snow helpers import-snowsql-connectionspara importar conexões de configurações existentes do SnowSQL.Adição do suporte para restringir o acesso do usuário somente a Snowflake CLI. Para obter mais informações, consulte Adicionar uma política de autenticação que limite apenas o acesso ao Snowflake CLI.
Correções de bugs¶
Correção da incapacidade de adicionar patches a versões entre aspas em letras minúsculas.
Correção de um problema ao definir o rótulo como em branco em vez de
Nonequando não fornecido.Correção do comando
snow connection generate-jwtpara preservar as opções de conexão da linha de comando.Correção do tratamento do caminho do estágio para comandos do notebook.