2024年の .NET Driver リリースノート

この記事には、 .NET Driver のリリースノートが含まれています。また、該当する場合は以下が含まれます。

  • 動作の変更

  • 新機能

  • 顧客向けバグ修正

Snowflake は、 .NET Driver の更新にセマンティックバージョニングを使用します。

バージョン3.0.0（2024年2月29日）

BCR （動作変更リリース）の変更

  • セキュリティを強化するため、ドライバーは、簡単なログ構成用の仮ディレクトリを検索しなくなりました。さらに、ドライバーには、ファイル所有者のみがファイルを変更できるようにファイル権限を制限するため、Unixスタイルのシステム上のログ構成ファイルが必要になりました（chmod 0600、 chmod 0644 など）。

  • ドライバーは PUT/GET の失敗に対して SnowflakeDbException と QueryID をスローするようになりました。以前、ドライバーは FileNotFound や DirectoryNotFound といった異なるタイプの例外をスローしていました。アプリケーションがこれらの例外を確認した場合は、 PUT/GET の失敗に対して SnowflakeDbException のみを処理するようにコードを更新する必要があります。

  • ドライバーは、チャンクパーサー/ダウンローダーのV1やV2のような古いバージョンをサポートしなくなりました。バージョンV3へのアップグレードの一環として、ドライバーは SFConfiguration.UseV2JsonParser または SFConfiguration.UseV2ChunkDownloader 構成オプションをサポートしなくなりました。以下のようなコマンドを使用していた場合は、削除する必要があります。

    • SFConfiguration.Instance().ChunkParserVersion = 1; または SFConfiguration.Instance().ChunkParserVersion = 2;

    • SFConfiguration.Instance().ChunkDownloaderVersion = 1; または SFConfiguration.Instance().ChunkDownloaderVersion = 2;

    • SFConfiguration.Instance().UseV2JsonParser

    • SFConfiguration.Instance().UseV2ChunkDownloader

新機能および改善

  • 複数の SAML 統合のサポートを追加しました。

バグ修正

  • 簡単なログ機能におけるセキュリティの向上には次が含まれます。

    • クライアント構成ファイルを検索する際に、どのドライバーディレクトリを使用するかを決定する、より信頼性の高い方法を使用する。

    • 構成検索に仮ディレクトリの使用をしなくなった。

    • セキュリティ強化のため、Unixで追加のファイル権限チェックを実施。

    • より詳細なログを追加。

  • SSO/SAML エンドポイント用Okta再試行の問題を修正。

  • テキスト実行を伴わないコマンドのフェールファストを追加。

  • PUT/GET の実行失敗時にスローされる例外に QueryId が含まれるように修正（可能な場合）。

  • Portable.BouncyCastle ライブラリを BouncyCastle.Cryptography に置き換えました。

バージョン2.2.0（2024年1月17日）

BCR （動作変更リリース）の変更

  • バージョン 2.2.0 以降、.NET ドライバーはアカウント名に基づいてホスト名を構築する際に、アカウント名のアンダースコア（_）をハイフン（-）に自動的に置き換えます。この変更は、アカウント名にアンダースコアが含まれる PrivateLink のお客様に影響します。この場合、 allowUnderscoresInHost を true に設定してデフォルト値を上書きする必要があります。 ConnectionString で allowUnderscoresInHost=true を設定して、この動作を上書きできます。

    この変更は、アカウント名にアンダースコアを含むSnowflakeアカウントでパブリックリンクを介して接続した場合に発生した、 DNS 解決エラーを修正するためのものです。

新機能および更新

  • Arrowパフォーマンスの改善

  • アカウント名に基づいてホスト名を作成する際に、アカウント名のアンダースコア（_）をハイフン（-）に自動的に置き換えます。

  • allowUnderscoresInHost 構成パラメーターを追加し、アカウント名のアンダースコア（_）を構築ホスト名で維持できるようにしました。このパラメーターを使用すると、本リリースに関連する動作変更を上書きできます。

バグ修正

  • 接続タイムアウトの問題を修正するため、接続時にドライバーが期限切れセッションを非同期に閉じるようになりました。

言語: 日本語