Microsoft.Data.SqlClient の新機能

Microsoft。Data.SqlClientは.NETとは独立して出荷されます。 この記事では、各リリースラインにおける重要な機能、挙動の変更点、互換性の変更点をまとめます。 リリーステーブルには、すべての安定パッケージの公開が含まれており、ホットフィックスや非公開パッケージも含まれます。 すべての修正や依存関係の更新については、 SqlClientリポジトリの完全なリリースノートをご覧ください。

最新リリース

本番環境でプレビューリリースは使わないでください。 プレビューAPIや動作は、一般公開(GA)前に変更されることがあります。

リリース表や一般提供サマリーはNuGetの出版月を使用しています。 ライフサイクル記事には公式リリース日が記載されており、異なる場合があります。 サポートウィンドウについては、 SqlClientドライバーのサポートライフサイクルを参照してください。

7.1プレビュー

7.1プレビューラインはバッチ処理、スキーマ発見、接続プーリング、そしてAlways Encrypted APIを拡張しています。 7.1.0-preview3 までの変更点には以下が含まれます:

• SqlBatch.NETフレームワークのサポート。
• 非同期 SqlConnection.GetSchemaAsync 過負荷。
• ColumnEncryption、ConnectTimeout、FailoverPartner、PacketSize、WorkstationIdなどの接続文字列エイリアス。
• SqlBulkCopy における $node_id、$edge_id、$from_id、$to_id の SQL Graph の疑似列マッピング。
• オプトイン接続に対するアイドル タイムアウトの適用。
• プーリング接続を待つ時間を含むオプトイン接続タイムアウトモードです。
• 実験的なチャネルベースの接続プールのさらなる発展。
• Always Encrypted キー ストア プロバイダーの非同期メソッド ドライバはまだコマンド実行時にこれらのメソッドを呼び出していないため、既存のAlways Encrypted操作を非同期にはしません。

SqlBatchCommand.CommandBehavior はこの系統から尊重される。 以前のバージョンではこの性質は無視されていました。 廃止された Type System Version=SQL Server 2000 接続オプションは、現在 ArgumentException をスローします。

Preview3は証明書とエンクレーブの検証も変更します。 ServerCertificate 常に設定済みの証明書ファイルとサーバーが提示する証明書を比較します。 無効または読み取れないファイルは、ホスト名検証に戻る代わりに接続に失敗します。 仮想セキュアモード(VSM)およびホストガーディアンサービス(HGS)のエンクレーブ認証は、エンクレーブ公開鍵が署名済み認証レポートに紐づいていることを検証します。 以前のプレビューから移動する際に、これらのパスを再度テストしてください。

このラインをテストする前に 、preview1、 preview2、 preview3 のリリースノートを読んでください。

7.0 STS

バージョン7.0は2026年3月に一般公開されました。 現在のSTSラインです。

特徴と変更点

• ドライバーによるMicrosoft Entra認証はコアパッケージからMicrosoft.Data.SqlClient.Extensions.Azureへ移行しました。 Active Directory認証モードを使うときに拡張機能パッケージを追加してください。
• コアパッケージはもはやAzure.Core、Azure.Identity、またはMicrosoft Authentication Library(MSAL)に依存しません。
• SqlConnection.SspiContextProvider カスタムKerberosおよびNTLMトークン交渉をサポートします。 プロバイダーの識別は接続プールキーの一部です。
• Azure SQL Hyperscaleおよび名前付きリードレプリカの強化ルーティングは自動的に交渉されます。
• 厳密に型指定されたコマンド、接続、およびトランザクションの診断イベントは、.NET Framework と現行の .NET で利用できます。
• SqlConfigurableRetryFactory.BaselineTransientErrors ドライバーのデフォルトの一時的エラーリストを公開します。
• Active Directory Password 認証は時代遅れです。 ユーザーアプリケーションにはインタラクティブ認証、サービスにはサービスプリンシパル認証、AzureホストワークロードにはマネージドIDを使いましょう。
• ターゲットサポートは.NET Framework 4.6.2および.NET 8から始まります。 このドライバーは.NET 10でのビルドと実行もサポートしています。

非同期読み取りのためのパケット多重化はプレビュー機能のままであり、7.0ではオプトイン(選択可能)となっています。 互換性スイッチは本番ワークロードでテストし、ロールバック手段を確保してください。

リリース

6.1 LTS

バージョン6.1.0は2025年7月にリリースされましたが、重要な回帰のため後にリストから外されました。 2025年8月にリリースされたバージョン6.1.1は、サポートされる6.1 LTSラインを確立しました。

特徴と変更点

• SqlVector<T> を介した SQL Server 2025 でのネイティブなベクトル転送。当初は単精度浮動小数点ベクトルに対応。
• ライブラリ互換性のための.NET Standard 2.0参照資産です。 このアセットはランタイム実装ではありません。 実行可能アプリケーションは、サポートされている.NETまたは.NET Frameworkのランタイムアセットを使用しなければなりません。
• 大規模な非同期読み取りに対するオプトインパケット多重化や、Microsoft FabricのSQLデータベースのエンドポイント処理が可能となります。
• ネイティブ AOT コンパイルのサポートを強化。
• 接続およびTDS処理経路の割り当て削減。
• 7.0で追加された公共セキュリティサポートプロバイダーインターフェース(SSPI)拡張性の内部基盤。

バージョン6.1.0は導入しないでください。 バージョン6.1.1は影響を受けたパケット検出および再生の変更を元に戻しました。

リリース

過去のリリースライン

以下のリリースラインは現在サポートされていません。 複数のドライバーバージョンをまたぐアップグレードを計画する際は、彼らのサマリーを活用してください。

6.0

バージョン6.0は2025年1月に一般公開されました。 最終パッチは2026年1月にリリースされた6.0.5でした。

• Microsoft.Data.SqlTypes.SqlJson を介して、読み取り、書き込み、ストリーミング、一括コピーパスを含むネイティブな SQL Server JSON のサポートを追加しました。
• コマンド、接続、およびトランザクション イベント向けの、公開された厳密に型指定された診断ペイロードが追加されました。
• OpenWithoutRetryを含むOpenAsync(SqlConnectionOverrides, CancellationToken)が追加されました。
• DataTableおよびSqlDataRecord構造化パラメータにおけるDateOnlyおよびTimeOnlyサポートを追加しました。
• .NET 9のサポートを追加しました。
• .NET Standardと.NET 6のランタイムアセットは廃止しました。 サポート対象は.NET Framework 4.6.2以降のバージョンと.NET 8以降のバージョンとなりました。
• テキストコマンドに限定 EnableOptimizedParameterBinding 。

リリース

5.2

バージョン5.2は2024年2月に一般公開されました。 最終パッチは2025年4月にリリースされた5.2.3でした。

• 非同期かつプール互換のトークン取得のための SqlConnection.AccessTokenCallback を追加しました。
• .NET 6以降のバージョンでSqlBatchとSqlBatchCommandを追加しました。
• .NETスタンダードでSqlDiagnosticListenerサポートを追加しました。
• 64ビット SqlBulkCopy.RowsCopied64を追加しました。 古い RowsCopied プロパティは32ビット整数のままです。
• Active Directory Workload Identity認証を追加しました。
• .NET 8およびビッグエンディアンプラットフォームのサポートを追加。
• UseOneSecFloorInTimeoutCalculationDuringLoginをデフォルトでtrueに変更しました。
• .NET 7以降のバージョンでマネージドSSPIにNegotiateAuthenticationを使用しました。

リリース

5.1

バージョン5.1は2023年1月に一般公開されました。 最終パッチは2026年1月にリリースされた5.1.9でした。

• .NET 6のサポートを追加し、.NET Core 3.1は廃止しました。
• パラメーター値およびTimeOnlyに対するGetFieldValueとDateOnlyのサポートを追加しました。
• .NETでTLS 1.3を追加し、ネイティブのSQL Serverネットワークインターフェース(SNI)パスも導入しました。
• Encrypt=MandatoryとEncrypt=Strictの証明書を正確に照合するためのServerCertificateを追加しました。
• .NETフレームワークのWindows ARM64サポートを追加しました。
• SqlConnectionEncryptOption文字列パーサーを公開しました。
• バージョン5.1.3はCVE-2024-0056の暗号化ダウングレードパスと証明書チェーン検証を修正しました。

リリース

5.0

バージョン5.0は2022年8月に一般公開されました。 最終パッチは2023年3月にリリースされた5.0.2でした。

• Encrypt=Strict を通じて TDS 8.0 を追加しました。 厳格モードはTDSログイン交換の前にTLSを開始し、常にサーバー証明書を検証します。
• SqlConnectionStringBuilder.EncryptをboolからSqlConnectionEncryptOptionに変更しました。
• SQL Server の共通言語ランタイム (CLR) 型を、個別にバージョン管理される Microsoft.SqlServer.Server パッケージに移動しました。
• Server SPNとFailover Server SPN接続オプションが追加されました。
• 現行.NETでWindows SQL Serverエイリアスサポートを追加しました。
• WindowsにSqlDataSourceEnumeratorを追加しました。
• .NET Framework 4.6.1を中止しました。

リリース

4.1

バージョン4.1は2022年1月に一般公開されました。 最終パッチは2022年9月にリリースされた4.1.1でした。

• 仮想化ベースセキュリティ(VBS)エンクレーブのための Attestation Protocol=None を追加しました。
• LinuxおよびmacOSでは、MultiSubnetFailoverが有効の場合、並列化されたSQL Server解決プロトコルのリクエストが行われます。
• 認証時の証明書取り消しリストチェックを固定しました。
• Microsoft Entra 認証、NULL SqlBinary値および rowversion 値、ならびに UTF-8 照合順序の動作に関する問題を修正しました。

リリース

4.0

バージョン4.0は2021年11月に一般公開されました。 最終パッチは2024年8月にリリースされた4.0.6でした。

• Encryptのデフォルト値を false から true に変更しました。
• 多くのパラメータを持つコマンド用の SqlCommand.EnableOptimizedParameterBinding を追加しました。
• .NET Standard 実装を通じて、Windows 向けに SqlFileStream を追加しました。
• マネージドSNIで共有LocalDBインスタンスのサポートを追加しました。
• XmlReader、TextReader、StreamのためのGetFieldValue<T>とGetFieldValueAsync<T>を追加しました。
• 設定可能な再試行ロジックから安全スイッチを削除しました。 リトライは、アプリケーションがプロバイダーを設定するまで無効化されたままでした。
• Microsoft Entra の認証失敗時に、SqlException ではなく AggregateException をスローするように変更しました。
• .NET Core 2.1をやめました。
• バージョン4.0.5はCVE-2024-0056の暗号化ダウングレードパスと証明書チェーン検証を修正しました。

リリース

3.1

バージョン3.1は2022年3月に一般公開されました。 最終パッチは2024年8月にリリースされた3.1.7でした。

• VBS エンクレーブ向けに Attestation Protocol=None を追加しました。
• SQLエラー42108と42109をデフォルトの一時的なエラーリストに追加しました。
• 3.1.2でWindows ARM64の.NETフレームワークサポートを追加しました。
• 3.1.3ではサイレントトークン取得により、Microsoft Entraトークンの繰り返し要求が減少しました。
• 3.1.5でCVE-2024-0056の暗号化ダウングレード経路を修正しました。
• 3.1.7では、プーリング前のトランザクションクリーンアップとMicrosoft Entraトークンのタイムアウト処理が修正されました。

リリース

3.0

バージョン3.0は2021年6月に一般公開されました。 最終パッチは2021年9月にリリースされた3.0.1でした。

• 接続およびコマンド操作のためのリトライロジックを追加しました。 3.0では、 Switch.Microsoft.Data.SqlClient.EnableRetryLogicの後ろにオプトインされたままでした。
• 接続やプールの活動用イベントカウンターを追加しました。
• Azure.Identity Active Directory Defaultを通じた認証を追加しました。
• 接続レベルおよびコマンド レベルの Always Encrypted キー ストア プロバイダー登録のサポートが追加されました。
• TCP IPアドレスの優先順位を追加しました。
• ユーザー割り当ての管理ID認証を、 User IdのオブジェクトIDではなくクライアントIDを使うように変更しました。
• SQL のrowversion のnull値を空のバイト配列の代わりに DBNull 返すように変更しました。 AppContextスイッチにより、従来の動作が維持されました。
• 最低の.NETフレームワーク目標を4.6から4.6.1に引き上げました。

システムキーストアプロバイダーは、3.0以降の接続やコマンドに登録されたプロバイダーよりも優先されます。 カスタムプロバイダーの名前が組み込みプロバイダーと矛盾する場合は、リネームしてください。

リリース

2.1

バージョン2.1は2020年11月に一般公開されました。 最終パッチは2024年1月にリリースされた2.1.7でした。

• Always Encryptedをサポートされた.NET Standard 2.0プラットフォームに拡張しました。
• Unix上で.NET Coreおよび.NET Standard 2.1プラットフォーム全体でセキュアなエンクレーブサポートを追加しました。
• Active Directory Device Code Flow とマネージド ID 認証を追加しました。
• インタラクティブおよびデバイスコード認証のためのカスタマイズフックが追加されました。
• 感度、分類、ランクのメタデータを追加しました。
• SqlConnection.ServerProcessIdを追加しました。
• 接続で作成されたコマンドのデフォルトとして Command Timeout 接続オプションを追加しました。
• バージョン2.1.7はCVE-2024-0056の暗号化ダウングレードパスを修正しました。

リリース

2.0

バージョン2.0は2020年6月に一般公開されました。 最終パッチは2020年8月にリリースされた2.0.1でした。

• .NET Coreおよび.NET StandardにActive Directory IntegratedおよびActive Directory Interactive認証を追加しました。
• Active Directory Service Principal認証を追加しました。
• Microsoft.Data.SqlClient.EventSource トレース機能を追加しました。
• クロスプラットフォームTCP keep-aliveと、テストとデバッグのためのWindows上でのオプトイン管理型ネットワーク実装を追加しました。 マネージドパスはドメイン外のWindows 認証をサポートしていませんでした。
• SqlBulkCopy.RowsCopied を追加し、一括コピーのヒントを順序付けしました。
• SqlConnection.Open(SqlConnectionOverrides.OpenWithoutRetry)を追加しました。
• Microsoft.Data.SqlClient.SNI.runtime 依存関係を介して、Windows ARM のサポートを追加しました。
• サーバーが暗号化を強制する際に、接続文字列がEncrypt=falseを設定する際にも、サーバー証明書の検証を開始しました。 証明書が信頼できなかったり、名前がサーバーと一致しない場合、このアップグレード後に接続が失敗することがあります。
• 10進パラメータのスケール処理を変更し、SQL Server互換の丸めを用います。

リリース

1.1

バージョン1.1は2019年11月に一般公開されました。 最終パッチは2021年3月にリリースされた1.1.4でした。

• サポートされる.NETフレームワークおよび.NETコアターゲットに、Always Encryptedと安全なエンクレーブを追加しました。
• .NET Core で |DataDirectory| に AttachDBFilename の展開を追加しました。
• マルチパケットターゲットバッファキャッシュによる非同期リードの改善。
• TdsParserStateObjectとSqlDataReaderでのスナップショットオーバーヘッドを削減します。
• 後のパッチでは、タイムアウト状態および複数アクティブ結果セット(MARS)ヘッダーエラーが修正されました。

リリース

1.0

Microsoft。Data.SqlClient 1.0は2019年8月に一般公開されました。 最終パッチは2019年9月にリリースされた1.0.19269.1でした。

• 別途発送された Microsoft.Data.SqlClient プロバイダーを導入しました。
• .NET Framework 4.6以降のバージョン、.NET Core 2.1以降のバージョン、.NET Standard 2.0をサポートしていました。
• .NETフレームワークにActive Directory Interactive認証を追加しました。
• .NET CoreにActive Directory Password認証を追加しました。
• SqlDataReaderにデータ感度分類メタデータを追加しました。
• SQL Server 2019 UTF-8のコレーションサポートを追加しました。
• .NET CoreでAlways Encryptedのサポートを追加しました。

リリース

古いプロバイダーから移行するアプリケーションの場合は、リリース ノートだけを読むのではなく、Migrate from System.Data.SqlClient to Microsoft.Data.SqlClient を参照してください。

オプションパッケージリリースノート

オプションパッケージにはそれぞれのリリースノートがあります。 バージョン7.0.2からは、コアドライバーとバージョンに合わせた形で出荷されるようになりました。

Microsoft.Data.SqlClient.Internal.Logging を直接参照しないでください。 これはドライバーパッケージ間で共有される内部依存関係です。

アップデートを評価する

1. すべてのドライバーおよびオプションパッケージのバージョンを直接的または推移的に特定してください。
2. アップデートで発生したすべてのマイナーおよびメジャーバージョンのリリースノートを読んでください。
3. ターゲットフレームワークおよびデータベース互換性については、 SqlClientドライバーのサポートライフサイクル を確認してください。
4. 関連するすべてのパッケージを互換性のあるバージョンに更新してください。
5. アプリケーションの認証、暗号化、接続プーリング、パラメータ、トランザクション、再試行、診断、デプロイ出力の構築とテストを行います。

インストールおよびデプロイ コマンドについては、「Microsoft.Data.SqlClient のインストール、更新、およびデプロイ」を参照してください。

関連するコンテンツ

• Microsoft.Data.SqlClient のインストール、更新、デプロイ
• SqlClient ドライバーのサポート ライフサイクル
• System.Data.SqlClientからMicrosoftへ移行してください。Data.SqlClient
• Microsoft。Data.SqlClient リリースノート