Notas de lançamento de .NET Driver para 2025¶
Este artigo contém as notas de versão do .NET Driver, incluindo o seguinte, quando aplicável:
Mudanças de comportamento
Novos recursos
Correções de bugs voltados para o cliente
Snowflake usa controle de versão semântico para atualizações de .NET Driver.
Consulte Driver .NET para ver a documentação.
Versão 4.8.0 (13 de agosto de 2025)¶
Novos recursos e atualizações¶
Adição de suporte para federação de identidade de carga de trabalho nas plataformas AWS, Azure, Google Cloud e Kubernetes.
Adição do parâmetro de conexão
WORKLOAD_IDENTITY_PROVIDER
.Adição de
WORKLOAD_IDENTITY
aos valores do parâmetro de conexãoauthenticator
.
Adição de suporte para tokens de atualização de uso único no fluxo OAuth.
Correções de bugs¶
Remoção da barra final do
RedirectUri
padrão dentro do processo de autorização OAuth.Correção de um problema ao ignorar a substituição do
ponto de extremidade
em implementações do AWS FIPS.
Versão 4.7.0 (1º de julho de 2025)¶
Recursos do Private Preview (PrPr)¶
Adição de suporte para federação de identidade de carga de trabalho nas plataformas AWS, Azure, GCP e Kubernetes.
Isenção de responsabilidade:
Esse recurso só pode ser acessado configurando a variável de ambiente
SF_ENABLE_EXPERIMENTAL_AUTHENTICATION
comotrue
.Você deve usar esse recurso somente com dados que não sejam de produção.
Esse recurso do PrPr não é coberto pelo suporte. No entanto, as equipes de Produto e Engenharia estão disponíveis durante a fase do PrPr.
Entre em contato com a equipe da sua conta para obter informações sobre participação e documentação.
Novos recursos e melhorias¶
Nenhum.
Correções de bugs¶
Defina
ConfigureAwait(false)
para autenticações assíncronas de token de acesso programático.Correção de um problema com a ausência do parâmetro
OAuthClientSecret
fornecido externamente para uma cadeia de conexão ao criar sessões que usam o recursoMinPoolSize
.
Versão 4.6.0 (18 de junho de 2025)¶
Novos recursos e melhorias¶
Adição de suporte para domínios de estilo virtual no Google Cloud Storage (GCS).
Adição de uma duração de tempo aos logs para chamadas HTTPS.
Adição de um cache de contexto de consulta de limpeza antes de agrupar uma conexão.
Correções de bugs¶
Habilitação do retorno de conjuntos de resultados para operações DML.
Adição de atualização de sessões expiradas ao buscar resultados de operações.
Versão 4.5.0 (09 de maio de 2025)¶
Novos recursos e melhorias¶
Adicionada a autenticação de fluxo do Código de Autorização OAuth 2.0:
Adicionado o autenticador
oauth_authorization_code
.Adicionados os parâmetros de conexão
oauthScope
,oauthClientId
,oauthClientSecret
,oauthAuthorizationUrl
,oauthTokenRequestUrl
eoauthRedirectUri
para configurar a autenticação.Adicionada a capacidade de fornecer
oauthClientSecret
definindo a propriedadeSnowflakeDbConnection.OAuthClientSecret
em vez de fornecê-la em uma cadeia de caracteres de conexão.Adicionado um cache para tokens OAuth 2.0.
Adicionada a autenticação de fluxo de credenciais de cliente OAuth 2.0:
Adicionado o autenticador
oauth_client_credentials
.Adicionados os parâmetros de conexão
oauthScope
,oauthClientId
,oauthClientSecret
eoauthTokenRequestUrl
para configurar a autenticação.Adicionada a capacidade de fornecer
oauthClientSecret
definindo a propriedadeSnowflakeDbConnection.OAuthClientSecret
em vez de fornecê-la em uma cadeia de caracteres de conexão.
Adicionada a autenticação de tokens de acesso programático:
Adicionado o autenticador
programmatic_access_token
.Adicionada a capacidade de especificar o parâmetro
token
em uma cadeia de caracteres de conexão ou ao definir a propriedadeSnowflakeDbConnection. Token
.
Adicionadas validações para as propriedades de conexão
scheme
,port
ehost
.Adicionada a capacidade de fornecer tokens definindo a propriedade
SnowflakeDbConnection. Token
em vez de fornecê-los em uma cadeia de caracteres de conexão.
Correções de bugs¶
Nenhum.
Versão 4.4.1 (28 de abril de 2025)¶
Novos recursos e melhorias¶
Nenhum.
Correções de bugs¶
Corrigida uma condição de corrida de tempo de verificação de tempo de uso (TOCTOU) ao verificar o acesso ao arquivo de configuração do Easy Logging. Para obter mais informações, consulte CVE-2025-46326.
Corrigido um problema com o cancelamento da conexão com
CancellationTokenSource.CancelAsync()
que não diminuía o contador de uso do pool.
Versão 4.4.0 (10 de abril de 2025)¶
Novos recursos e melhorias¶
Adicionado um cache de token SSO para autenticação externa do navegador e o parâmetro
client_store_temporary_credential
para indicar se o cache SSO deve ser usado.Implementação e melhoria do cache de credenciais baseado em arquivo para Linux, incluindo cache de token aprimorado.
Correções de bugs¶
Correção da não diferenciação de maiúsculas e minúsculas para autenticadores. Antes da correção, a lógica para
username_password_mfa
eoauth
não era aplicada corretamente se os autenticadores usassem caracteres maiúsculos.Corrigido um problema com a passagem de null em um parâmetro de consulta.
Corrigido um problema com a leitura de tokens do Windows Credential Manager, que era usado para o autenticador
username_password_mfa
. Em alguns casos, o valor lido do gerenciador de credenciais pode ser muito longo.Fiz algumas pequenas alterações nas implementações do gerenciador de credenciais, como a alteração de alguns níveis de registro e a emissão de um aviso para permissões de diretório de cache muito permissivas no Unix, em vez de alterar as permissões automaticamente.
Corrigida a vinculação dos parâmetros
AnsiString
ao tipoTEXT
.Corrigido o carregamento de dados estruturados ou semiestruturados em um
DataTable
.
Versão 4.3.0 (29 de janeiro de 2025)¶
Novos recursos e melhorias¶
Adição de suporte para configuração de parâmetros de conexão em arquivos TOML.
Adição de um cache de token de MFA.
Adição de suporte para pontos de extremidade do GCP específicos da região.
Os cabeçalhos de criptografia dos arquivos baixados pelo GET não diferenciam maiúsculas de minúsculas.
O driver foi testado com o framework .net9.
Extensão da documentação para verificar os pontos de extremidade do CRL para usuários do Windows.
Correções de bugs¶
Melhoria da segurança dos arquivos intermediários colocados em diretórios temporários do OS, o que faz com que os arquivos não sejam mais legíveis de forma mundial. Para obter mais informações, consulte CVE-2025-24788.
Correção de um problema com o tratamento de dados nulos em respostas com falha.
Correção de um problema com o registro de informações de diagnóstico.
Correção de um problema com o tratamento de espaços no caminho do arquivo para o comando PUT com o GCS (Google Cloud Storage).
Correção de um problema com o tratamento de pontos de extremidade do GCS sem o prefixo
https://
.Correção de um problema com o download de arquivos com uma operação GET que não tem a propriedade
SFC_DIGEST
em seus metadados.Correção da capacidade de usar
STDOUT
como o caminho de log no recurso Easy Logging.