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ão authenticator.

  • 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 como true.

  • 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 recurso MinPoolSize.

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 e oauthRedirectUri para configurar a autenticação.

    • Adicionada a capacidade de fornecer oauthClientSecret definindo a propriedade SnowflakeDbConnection.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 e oauthTokenRequestUrl para configurar a autenticação.

    • Adicionada a capacidade de fornecer oauthClientSecret definindo a propriedade SnowflakeDbConnection.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 propriedade SnowflakeDbConnection. Token.

  • Adicionadas validações para as propriedades de conexão scheme, port e host.

  • 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 e oauth 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 tipo TEXT.

  • 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.