Notes de version de .NET Driver pour 2024

Cet article contient les notes de version .NET Driver, y compris les éléments suivants, le cas échéant :

  • Changements de comportement

  • Nouvelles fonctionnalités

  • Corrections de bogues pour les clients

Snowflake utilise la version sémantique pour les mises à jour .NET Driver.

Version 3.0.0 (29 février 2024)

Changements BCR (Version de changement de comportement)

  • Pour améliorer la sécurité, le pilote ne recherche plus de répertoire temporaire pour faciliter les configurations d’enregistrement. En outre, le pilote exige désormais que le fichier de configuration de la journalisation sur les systèmes de type Unix limite les autorisations de fichiers afin que seul le propriétaire du fichier puisse modifier les fichiers (par exemple chmod 0600, chmod 0644).

  • Le pilote lance désormais un SnowflakeDbException avec un QueryID pour les échecs PUT/GET. Auparavant, le pilote renvoyait différents types d’exceptions, tels que FileNotFound et DirectoryNotFound. Si votre application a vérifié l’une de ces exceptions, vous devez mettre à jour votre code pour ne traiter que SnowflakeDbException pour les échecs PUT/GET.

  • Le pilote ne prend plus en charge les anciennes versions, telles que V1 et V2, de l’analyseur/téléchargeur de morceaux. Dans le cadre de la mise à niveau vers la version V3, le pilote ne prend plus en charge les options de configuration SFConfiguration.UseV2JsonParser ou SFConfiguration.UseV2ChunkDownloader. Si vous avez utilisé des commandes similaires aux suivantes, vous devez les supprimer :

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

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

    • SFConfiguration.Instance().UseV2JsonParser

    • SFConfiguration.Instance().UseV2ChunkDownloader

Nouvelles fonctionnalités et améliorations

  • Ajout de la prise en charge de plusieurs intégrations SAML.

Corrections de bogues

  • Amélioration de la sécurité de la fonction d’enregistrement facile, notamment :

    • Utilisation d’une méthode plus fiable pour déterminer le répertoire des pilotes à utiliser lors de la recherche des fichiers de configuration du client.

    • Plus d’utilisation d’un répertoire temporaire pour la recherche de configuration.

    • Mise en œuvre de contrôles supplémentaires des autorisations de fichiers sous Unix pour une sécurité accrue.

    • Ajout d’une journalisation plus verbeuse.

  • Correction d’un problème de réessai d’Okta pour les points de terminaison SSO/SAML.

  • Ajout d’un échec rapide pour les commandes sans exécution de texte.

  • Correction des exceptions générées par l’échec des exécutions PUT/GET pour qu’elles contiennent QueryId si possible.

  • Remplacement de la bibliothèque Portable.BouncyCastle par BouncyCastle.Cryptography.

Version 2.2.0 (17 janvier 2024)

Changements BCR (Version de changement de comportement)

  • À partir de la version 2.2.0, le pilote .NET remplace automatiquement les traits de soulignement (_) dans les noms de comptes par des traits d’union (-) lors de la construction d’un nom d’hôte basé sur un nom de compte. Ce changement a un impact sur les clients PrivateLink dont les noms de compte contiennent des caractères de soulignement. Dans cette situation, vous devez remplacer la valeur par défaut en donnant à allowUnderscoresInHost la valeur true. Vous pouvez ignorer ce comportement en plaçant allowUnderscoresInHost=true dans ConnectionString.

    Cette modification a été apportée pour corriger les erreurs de résolution DNS qui se produisaient lors de la connexion via le lien public avec des comptes Snowflake dont les noms de compte comportaient des traits de soulignement.

Nouvelles fonctions et mises à jour

  • Amélioration des performances Arrow

  • Remplace automatiquement les traits de soulignement (_) dans les noms de compte par des traits d’union (-) lors de la construction d’un nom d’hôte basé sur un nom de compte.

  • Ajout d’un paramètre de configuration allowUnderscoresInHost pour permettre aux traits de soulignement (_) dans les noms de comptes d’être maintenus dans le nom d’hôte construit. Ce paramètre vous permet d’ignorer le changement de comportement associé à cette version.

Corrections de bogues

  • Afin de résoudre un problème lié aux délais d’expiration de connexion, le pilote ferme désormais les sessions expirées de manière asynchrone lors de la connexion.

Langage: Français