Notas de lançamento de .NET Driver para 2024

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.

Versão 3.0.0 (29 de fevereiro de 2024)

Mudanças de BCR (versão da mudança de comportamento)

  • Para aumentar a segurança, o driver não pesquisa mais um diretório temporário para configurações de registro fáceis. Além disso, o driver agora exige que o arquivo de configuração de log em sistemas estilo Unix limite as permissões de arquivo para permitir que apenas o proprietário do arquivo modifique os arquivos (como chmod 0600, chmod 0644).

  • O driver agora lança um SnowflakeDbException com um QueryID para falhas de PUT/GET. Anteriormente, o driver retornava diferentes tipos de exceções, como FileNotFound e DirectoryNotFound. Se seu aplicativo verificou alguma dessas exceções, você deverá atualizar seu código para lidar apenas com SnowflakeDbException para falhas PUT/GET.

  • O driver não oferece mais suporte a versões mais antigas, como V1 e V2, do analisador/baixador das partes. Como parte da atualização para a versão V3, o driver não oferece mais suporte às opções de configuração SFConfiguration.UseV2JsonParser ou SFConfiguration.UseV2ChunkDownloader. Se você usou comandos semelhantes aos seguintes, você deve removê-los:

    • SFConfiguration.Instance().ChunkParserVersion = 1; ou SFConfiguration.Instance().ChunkParserVersion = 2;

    • SFConfiguration.Instance().ChunkDownloaderVersion = 1; ou SFConfiguration.Instance().ChunkDownloaderVersion = 2;

    • SFConfiguration.Instance().UseV2JsonParser

    • SFConfiguration.Instance().UseV2ChunkDownloader

Novos recursos e melhorias

  • Adição de suporte para múltiplas integrações SAML.

Correções de bugs

  • Segurança aprimorada no recurso de registro fácil, incluindo:

    • Como usar uma maneira mais confiável de determinar qual diretório de driver usar ao procurar arquivos de configuração do cliente.

    • Não utiliza mais um diretório temporário para pesquisa de configuração.

    • Como aplicar verificações adicionais de permissões de arquivo no Unix para aumentar a segurança.

    • Como adicionar registros mais detalhados.

  • Foi corrigido um problema de nova tentativa do Okta para pontos de extremidade SSO/SAML.

  • Adicionada falha rápida para comandos sem execução de texto.

  • Corrigidas exceções lançadas de execuções com falha PUT/GET para conter QueryId, se possível.

  • Substituída a biblioteca Portable.BouncyCastle por BouncyCastle.Cryptography.

Versão 2.2.0 (17 de janeiro de 2024)

Mudanças de BCR (versão da mudança de comportamento)

  • A partir da versão 2.2.0, o driver .NET substitui automaticamente sublinhados (_) em nomes de contas por hífens (-) ao criar um nome de host com base em um nome de conta. Esta mudança afeta os clientes PrivateLink cujos nomes de conta contêm sublinhados. Nesta situação, você deve substituir o valor padrão definindo allowUnderscoresInHost por true. Você pode substituir esse comportamento definindo allowUnderscoresInHost=true em ConnectionString.

    Essa alteração foi feita para corrigir os erros de resolução DNS que ocorriam ao conectar-se pelo link público com contas Snowflake que tinham sublinhados em seus nomes de conta.

Novos recursos e atualizações

  • Desempenho aprimorado do Arrow.

  • Substitui automaticamente sublinhados (_) em nomes de contas por hífens (-) ao criar um nome de host com base em um nome de conta.

  • Adicionado um parâmetro de configuração allowUnderscoresInHost para permitir que sublinhados (_) em nomes de contas sejam mantidos no nome do host criado. Este parâmetro permite substituir a alteração de comportamento associada a esta versão.

Correções de bugs

  • Para corrigir um problema com tempos limite de conexão, o driver agora fecha sessões expiradas de forma assíncrona durante a conexão.

Linguagem: Português