Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Microsoft. Data.SqlClient, .NET'ten bağımsız olarak gönderilir. Bu makale, her sürüm serisindeki önemli özellikleri, davranış değişikliklerini ve uyumluluk değişikliklerini özetlemektedir. Sürüm tabloları, her acil düzeltme ve listelenmemiş paket de dahil olmak üzere tüm kararlı paket yayımlarını içerir. Her düzeltme ve bağımlılık güncellemesi için SqlClient deposundaki tam sürüm notlarına bakabilirsiniz.
Geçerli sürümler
| Çıkış hattı | En son sürüm | Yayınlanma tarihi | Support |
|---|---|---|---|
| 7.0 | 7.0.3 | Eylül 2026 | Standart Süreli Destek (STS) |
| 6.1 | 6.1.7 | Eylül 2026 | Uzun Vadeli Destek (LTS) |
| 7.1 önizleme | 7.1.0-önizleme3.26238.4 | Ağustos 2026 | Preview |
Üretimde önizleme sürümlerini kullanmayın. Önizleme API'leri ve davranışları Genel Erişilebilirlikten (GA) önce değişebilir.
Yayın tabloları ve genel erişilebilirlik özetleri NuGet yayın ayını kullanır. Yaşam döngüsü makalesi, farklı olabilecek resmi çıkış tarihlerini listeliyor. Destek pencereleri için SqlClient sürücü destek yaşam döngüsü sayfasına bakınız.
7.1 önizleme
7.1 önizleme satırı, toplu çalışma, şema keşfi, bağlantı havuzu ve Her Zaman Şifrelenmiş API'leri genişletiyor. 7.1.0-preview3 ile yapılan değişiklikler şunları içerir:
-
SqlBatch.NET Framework desteği. - Asenkron
SqlConnection.GetSchemaAsyncaşırı yüklenmeler. -
ColumnEncryption,ConnectTimeout,FailoverPartner,PacketSizeveWorkstationIdgibi bağlantı dizisi takma adları. -
$to_idiçindeki$node_id,SqlBulkCopy,$edge_idve$from_idiçin SQL Graph sözde sütun eşlemeleri. - İsteğe bağlı bağlantı boşta kalma zaman aşımı uygulaması.
- Havuzdaki bir bağlantıyı beklerken geçen süreyi de içeren, isteğe bağlı olarak etkinleştirilebilen bir bağlantı zaman aşımı modu.
- Deneysel kanal tabanlı bağlantı havuzunun daha da geliştirilmesi.
- Always Encrypted anahtar deposu sağlayıcılarındaki asenkron yöntemler. Sürücü henüz komut çalıştırma sırasında bu yöntemleri çağırmıyor, bu yüzden mevcut Always Encrypted işlemleri asenkron hale getirmiyor.
SqlBatchCommand.CommandBehavior bu satırdan itibaren geçerli olur. Önceki sürümlerde bu özellik göz ardı edilmişti. Kullanımdan kalkmış Type System Version=SQL Server 2000 bağlantı seçeneği artık bir ArgumentException hatası verir.
Preview3 ayrıca sertifika ve enclave doğrulamasını da değiştiriyor.
ServerCertificate her zaman yapılandırılmış sertifika dosyasını sunucu tarafından sunulan sertifikayla karşılaştırır. Geçersiz veya okunamayan bir dosya artık ana bilgisayar adı doğrulamasına başvurmak yerine bağlantının başarısız olmasına neden olur. Sanal Güvenli Mod (VSM) ve Host Guardian Service (HGS) enclave doğrulaması artık enklav açık anahtarının imzalı doğrulama raporuna bağlı olduğunu doğrular. Önceki bir önizlemeden geçtiğinizde bu yolları tekrar test edin.
Bu dalı test etmeden önce preview1, preview2 ve preview3 sürüm notlarını okuyun.
7.0 STS
Sürüm 7.0, Mart 2026'da genel kullanıma sunuldu. Bu, geçerli STS hattıdır.
Özellikler ve değişiklikler
- Sürücü tarafından sağlanan Microsoft Entra kimlik doğrulaması, çekirdek paketten
Microsoft.Data.SqlClient.Extensions.Azurekonumuna taşındı. Doğrulama modu kullandığınızdaActive Directoryuzantı paketini ekleyin. - Çekirdek paket artık
Azure.Identity,Azure.Coreveya Microsoft Authentication Library’ye (MSAL) bağımlı değildir. -
SqlConnection.SspiContextProviderözel Kerberos ve NTLM token müzakere desteğini destekler. Sağlayıcı kimliği, bağlantı havuzu anahtarının bir parçasıdır. - Azure SQL Hyperscale ve adlandırılmış okuma replikaları için geliştirilmiş yönlendirme otomatik olarak gerçekleştirilir.
- Güçlü tipli komut, bağlantı ve işlem tanı olayları .NET Framework ve mevcut .NET üzerinde mevcuttur.
-
SqlConfigurableRetryFactory.BaselineTransientErrorssürücünün varsayılan geçici hata listesini açığa çıkarır. -
Active Directory PasswordKimlik doğrulama modası geçmiştir. Kullanıcı uygulamaları için etkileşimli kimlik doğrulama, hizmetler için hizmet ana doğrulama veya Azure barındırılan iş yükleri için yönetilen kimlik kullanın. - Hedef destek .NET Framework 4.6.2 ve .NET 8'de başlar. Sürücü ayrıca .NET 10 üzerinde kurma ve çalıştırmayı destekler.
Asenkron okumalar için paket çoklama, önizleme işlevi olmaya devam ediyor ve 7.0'da isteğe bağlıdır. Uyumluluk anahtarlarını üretim iş yükleriyle test edin ve bir geri alma seçeneğini hazır bulundurun.
Yayınlar
| Version | Serbest bırakıldı | Müşteri açısından ilgili değişiklikler |
|---|---|---|
| 7.0.0 | Mart 2026 | Genel kullanıma sunulma sürümü. |
| 7.0.1 | Nisan 2026 | SQL Server 2016 ve Azure Synapse Analytics özel SQL havuzları için metaveri sorguları düzeltildiSqlBulkCopy, vektör alanı metaverisi düzeltildi, eksik .NET Framework System.Data.Common bağımlılığı eklendi ve kimlik doğrulama soyutlamaları için tür yönlendirme eklendi. |
| 7.0.2 | Haziran 2026 | Çekirdek sürücü ve yardımcı paketler uyumlu hale getirildi, TDS belirteç ayrıştırması güçlendirildi, Always Encrypted imza doğrulama önbelleğinin işlenmesi düzeltildi ve iptal işlemlerindeki ve null-buffer GetBytes ile GetChars çağrılarındaki hatalar giderildi. |
| 7.0.3 | Eylül 2026 | SNI 6.0.3'e güncellendi.
ServerCertificate okuyamayan oturum açmalar için bir regresyon sys.all_columns, izleme devre dışıyken bellek ayırma regresyonu, yönetilen SNI'da SqlBulkCopy doğrulaması, Always Encrypted enclave tasdik anahtarı doğrulaması ve işlem genelinde bir derleme çözümleme işleyicisinin kaydedilmesi için yapılandırılabilir yeniden deneme düzeltildi. |
Important
7.0.2'den itibaren doğrudan referansları Microsoft.Data.SqlClient, Microsoft.Data.SqlClient.Extensions.Azure, Microsoft.Data.SqlClient.Extensions.Abstractions, ve Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProviderile hizala.
Microsoft.Data.SqlClient.Internal.Logging geçişli olarak çözümlesin. .NET Framework'te, Extensions.Abstractions, Internal.Logging ve Extensions.Azure derlemelerinin sürümleri 1.0.0.0 sürümünden 7.0.0.0 sürümüne değişti. Bu paketleri güncellerken uygulamayı yeniden oluştur veya bağlama yönlendirmeleri ekleyin.
6.1 LTS
6.1.0 sürümü Temmuz 2025'te yayımlandı, ancak eleştirel gerilemeler nedeniyle listeden çıkarıldı. Ağustos 2025'te yayımlanan 6.1.1 sürümü, desteklenen 6.1 LTS serisini oluşturdu.
Özellikler ve değişiklikler
- SQL Server 2025 için
SqlVector<T>aracılığıyla yerel vektör aktarımı, başlangıçta yalnızca tek duyarlıklı kayan noktalı vektörler için. - Kütüphane uyumluluğu için bir .NET Standard 2.0 referans varlığı. Bu varlık bir çalışma zamanı uygulaması değildir. Çalıştırılabilir uygulamalar, desteklenen bir .NET veya .NET Framework çalışma zamanı varlığını kullanmalıdır.
- Microsoft Fabric’te büyük hacimli asenkron okumalar için isteğe bağlı paket çoğullama çalışmaları ve SQL veritabanı için uç nokta işlemleri.
- Geliştirilmiş yerel önceden derleme (AOT) desteği.
- Bağlantı ve TDS işleme yollarındaki ayırmalar azaltıldı.
- 7.0'da kamu Güvenlik Destek Sağlayıcı Arayüzü (SSPI) genişletilebilirliği için iç temel çalışmalar eklendi.
6.1.0 sürümünü dağıtmayın. 6.1.1 sürümü, etkilenen paket algılama ve tekrar oynatma değişikliklerini geri aldı.
Yayınlar
| Version | Serbest bırakıldı | Müşteri açısından ilgili değişiklikler |
|---|---|---|
| 6.1.0 | Temmuz 2025 | Genel kullanıma sunulma sürümü. Bu paket, kritik gerilemeler nedeniyle listeden çıkarıldı. Onu kullanma. |
| 6.1.1 | Ağustos 2025 | 6.1.0 sürümündeki kısmi paket algılama, düzeltme ve yeniden oynatma değişiklikleri geri döndürüldü. Düzeltilmiş vektör referans montajları ve SqlVector<T>.Null. |
| 6.1.2 | Ekim 2025 | Erken performans sayacı başlatma, özel kimlik doğrulama sağlayıcılarının değiştirilmesi ve havuz eşzamanlılığı düzeltildi; bu durum yapılandırılmış maksimum havuz boyutunun kullanılmasını engelledi. |
| 6.1.3 | Kasım 2025 | Temel Erişilebilirlik Grupları ve özel portlar için eklendi IgnoreServerProvidedFailoverPartner . EventSource metriklerinin erken başlatılması düzeltildi. |
| 6.1.4 | Ocak 2026 |
EnableMultiSubnetFailoverByDefault eklendi.
SqlDataAdapter toplu işleme hataları ve havuz ölçümlerindeki negatif etkin bağlantı sayıları düzeltildi. |
| 6.1.5 | Nisan 2026 | Entegre olmayan kimlik doğrulama için gereksiz Hizmet Başlı Adı (SPN) ve Alan Adı Sistemi (DNS) çalışmaları kaldırıldı, ExecuteScalar veri sonrası geri dönen sunucu hatalarının yayılması sağlandı ve vektör meta veri türleri düzeltildi. |
| 6.1.6 | Haziran 2026 | Opt-in Windows Web Hesap Yöneticisi (WAM) aracı desteği eklendi, TDS belirteci ayrıştırması güçlendirildi, önbelleğe alınmış sütun ana anahtarı imza hataları düzeltildi ve GetChars argüman doğrulaması düzeltildi. |
| 6.1.7 | Eylül 2026 | SNI 6.0.3'e güncellendi. Yönetilen SNI'da AccessTokenCallback doğrulama, Always Encrypted enklav tasdik anahtarı doğrulaması, ServerCertificate bağlantı yeniden deneme davranışı ve işlem genelinde bir derleme çözümleme işleyicisi kaydeden yapılandırılabilir yeniden deneme düzeltildi. |
Önceki yayın serileri
Aşağıdaki sürüm satırları artık desteklenmemektedir. Birden fazla sürücü versiyonu için yükseltme planlarken özetlerini kullanın.
6.0
6.0 sürümü Ocak 2025'te genel kullanıma sunuldu. Son yama 6.0.5 idi ve Ocak 2026'da yayımlandı.
-
Microsoft.Data.SqlTypes.SqlJsonaracılığıyla okuma, yazma, akış ve toplu kopyalama işlemleri için yerel SQL Server JSON desteği eklendi. - Komut, bağlantı ve işlem olayları için genel, güçlü olarak türlendirilmiş tanılama yükleri eklendi.
-
OpenAsync(SqlConnectionOverrides, CancellationToken)eklendi,OpenWithoutRetrydahil. -
DataTableveSqlDataRecordyapılandırılmış parametrelerineDateOnlyveTimeOnlydesteği eklendi. - .NET 9 desteği eklendi.
- .NET Standard ve .NET 6 çalışma zamanı bileşenleri kaldırıldı. Desteklenen hedefler .NET Framework 4.6.2 ve daha sonraki sürümler ile .NET 8 ve sonraki sürümler oldu.
- Sadece
EnableOptimizedParameterBindingmetin komutlarıyla sınırlı.
Yayınlar
| Version | Serbest bırakıldı | Müşteri açısından ilgili değişiklikler |
|---|---|---|
| 6.0.0 | Ocak 2025 | Genel kullanıma sunulma sürümü. Bu paket NuGet'te listelenmemiş ve üst akış notlarında bir sebep belgelenmiyor. |
| 6.0.1 | Ocak 2025 | Referans API'leri, aşağı seviye TLS uyarıları ve bağımlılıklar düzeltildi SqlClientDiagnostic . |
| 6.0.2 | Nisan 2025 | Olası soket alıcı null hataları, SqlJson referans API'leri, JSON çıkış parametreleri ve bağımlılıklar düzeltildi. |
| 6.0.3 | Ekim 2025 | Özel kimlik doğrulama sağlayıcılarının değiştirilmesi önlendi ve Max Pool Size öğesini yeterince kullanmayan havuz eşzamanlılığı düzeltildi. |
| 6.0.4 | Kasım 2025 | Özel TCP portları kullanan Temel Erişilebilirlik Grupları için eklenmiştir Switch.Microsoft.Data.SqlClient.IgnoreServerProvidedFailoverPartner . |
| 6.0.5 | Ocak 2026 |
SqlDataAdapter toplu RPC'de null işleme düzeltildi, Switch.Microsoft.Data.SqlClient.EnableMultiSubnetFailoverByDefault eklendi ve bağımlılıklar güncellendi. |
5.2
Sürüm 5.2, Şubat 2024'te genel kullanıma sunuldu. Son yama ise Nisan 2025'te yayımlanan 5.2.3'tü.
- Asenkron, havuz uyumlu belirteç edinimi için
SqlConnection.AccessTokenCallbackeklendi. - .NET 6 ve sonraki sürümlere
SqlBatchveSqlBatchCommandeklendi. - .NET Standard için destek eklendi
SqlDiagnosticListener. -
SqlBulkCopy.RowsCopied64için 64 bit desteği eklendi. EskiRowsCopiedözellik ise 32 bitlik tam sayılı olarak kalmaktadır. -
Active Directory Workload Identitykimlik doğrulama eklendi. - .NET 8 ve big-endian platform desteği eklendi.
-
UseOneSecFloorInTimeoutCalculationDuringLogin, varsayılan olaraktrueşeklinde değiştirildi. - .NET 7 ve sonraki sürümlerde yönetilen SSPI için kullanılmıştır
NegotiateAuthentication.
Yayınlar
| Version | Serbest bırakıldı | Müşteri açısından ilgili değişiklikler |
|---|---|---|
| 5.2.0 | Şubat 2024 | Genel kullanıma sunulma sürümü. |
| 5.2.1 | Mayıs 2024 | Bağlantı noktalarıyla Linux’ta adlandırılmış örnek bağlantıları, FireInfoMessageEventOnUserErrors, datetimeoffset(n) tablo değerli parametreleri, gecikmeli OpenAsync ve AccessTokenCallback öğesinin SqlConnection.Clone() tarafından korunması düzeltildi. |
| 5.2.2 | Ağustos 2024 | Sabit token zaman aşımları, yönetilen SNI soket bağlantıları, montaj hedefleme, SSPI tekrarları, kullanıcı tanımlı tip okumaları ve şifrelenmiş okuyucu verileri. CVE-2024-35255 için güncellenmiş kimlik paketleri. |
| 5.2.3 | Nisan 2025 | Olası soket-alıcı null hataları ve referans-montaj tutarsızlıklarını düzeltti, negatif geçici hata sayılarına izin verdi ve bağımlılıklar güncellendi. |
5.1
Sürüm 5.1, Ocak 2023'te genel kullanıma sunuldu. Son yama ise Ocak 2026'da yayımlanan 5.1.9'du.
- .NET 6 desteği eklendi ve .NET Core 3.1 bırakıldı.
- Parametre değerleri ve
TimeOnlyiçinGetFieldValueveDateOnlydesteği eklendi. - .NET'te TLS 1.3 ve yerel SQL Server Ağ Arayüzü (SNI) yolları eklendi.
-
Encrypt=StrictveServerCertificateile tam sertifika eşleştirmesi içinEncrypt=Mandatoryeklendi. - .NET Framework için Windows ARM64 desteği eklendi.
-
SqlConnectionEncryptOptionstring ayrıştırıcısını genel kullanıma açtık. - Sürüm 5.1.3, CVE-2024-0056 şifreleme aşağı seviye yolunu ve sertifika zinciri doğrulamasını düzeltti.
Yayınlar
| Version | Serbest bırakıldı | Müşteri açısından ilgili değişiklikler |
|---|---|---|
| 5.1.0 | Ocak 2023 | Genel kullanıma sunulma sürümü. |
| 5.1.1 | Mart 2023 | Always Encrypted hata raporlaması, yönlendirme modu işlemleri, belirteç kısıtlaması, büyük sorgularda görülen TDS RPC hataları ve GetBytesAsync null değerinin işlenmesiyle ilgili sorunlar düzeltildi. |
| 5.1.2 | Ekim 2023 | Sabit SQL Express kullanıcı örnekleri, enclave tekrarları, LocalDB, bağlantı dizisi oluşturucu değerleri, SqlConnectionEncryptOption yapılandırma dönüşümü ve OpenAsync geçici hatalar. |
| 5.1.3 | Ocak 2024 | CVE-2024-0056 ve sertifika zinciri doğrulamasıyla ilgili sorunlar giderildi. |
| 5.1.4 | Ocak 2024 | .NET dağıtık işlem kilitlenmesi düzeltildi ve CVE-2023-36414 için Azure.Identity yükseltildi. |
| 5.1.5 | Ocak 2024 | Havuzlamadan önceki işlem temizleme ve Always Encrypted tarih/saat dönüştürme hataları düzeltildi. CVE-2024-21319 için güncellenmiş IdentityModel bağımlılıkları. |
| 5.1.6 | Ağustos 2024 |
OpenAsync, kimlik doğrulama zaman aşımı ve şifrelenmiş okuyucuda bekleyen veri hataları düzeltildi. CVE-2024-35255 ve önbelleklenmiş TokenCredential örnekler için kimlik bağımlılıkları güncellendi. |
| 5.1.7 | Nisan 2025 | Olası bir soket alımı null hatası düzeltildi, kaynak ve başvuru derlemeleri hizalandı ve bağımlılıklar güncellendi. |
| 5.1.8 | Kasım 2025 | Eklendi Switch.Microsoft.Data.SqlClient.IgnoreServerProvidedFailoverPartner, toplu kopyada UTF-8 bayt sipariş işareti işleme düzeltildi, MSAL üretimi modernize edildi ve bağımlılıklar güncellendi. |
| 5.1.9 | Ocak 2026 |
Environment.TickCount zamanlaması SqlStatistics konumuna taşındı ve çerçeveye özgü bağımlılıklar güncellendi. |
5.0
Sürüm 5.0, Ağustos 2022'de genel kullanıma sunuldu. Son yama ise Mart 2023'te yayımlanan 5.0.2 idi.
- TDS 8.0’a kadar
Encrypt=Stricteklendi. Sıkı mod, TDS giriş değişiminden önce TLS'yi başlatır ve her zaman sunucu sertifikasını doğrular. -
SqlConnectionStringBuilder.Encrypt,booldeğerindenSqlConnectionEncryptOptiondeğerine değiştirildi. - SQL Server ortak dil çalışma zamanı (CLR) tiplerini ayrı sürümlü
Microsoft.SqlServer.Serverpakete taşıdım. - Eklendi
Server SPNveFailover Server SPNbağlantı seçenekleri. - Mevcut .NET'Windows SQL Server takma ad desteği eklendi.
-
SqlDataSourceEnumeratorWindows'ta eklendi. - .NET Framework 4.6.1 kaldırıldı.
Important
SqlConnectionStringBuilder.Encrypt türündeki değişiklik ikili uyumluluğu bozar.
Microsoft.Data.SqlClient.Server’dan kaldırılan türlerin Microsoft.SqlServer.Server kullanabilmesi için de kaynakta değişiklikler gerekir. Uygulamaları ve kitaplıkları yeniden derleyin, ad alanlarını güncelleyin ve System.Data.SqlClient başvurulmaya devam ediyorsa ad alanı çakışmalarını denetleyin.
Yayınlar
| Version | Serbest bırakıldı | Müşteri açısından ilgili değişiklikler |
|---|---|---|
| 5.0.0 | Ağustos 2022 | Genel kullanıma sunulma sürümü. |
| 5.0.1 | Ekim 2022 | .NET Framework'te geri yüklendi HostNameInCertificate ve dikkat çıkmazları, SqlConnectionStringBuilder.Encryptiptal kayıtları, yönetilen SNI takıntıları, UTF-8 derlemesi ve SNI uygulama alanı çökmesi düzeltildi. |
| 5.0.2 | Mart 2023 | Asenkron okuma sırasında oluşan bellek sızıntısı, yönlendirme modu TransactionScope, Always Encrypted hataları, büyük sorgularda görülen TDS RPC hataları ve dağıtık işlem kilitlenmeleri düzeltildi. |
4.1
Sürüm 4.1, Ocak 2022'de genel kullanıma sunuldu. Son yama, Eylül 2022'de çıkan 4.1.1 idi.
- Sanallaştırma tabanlı güvenlik (VBS) korumalı alanları için
Attestation Protocol=Noneeklendi. -
MultiSubnetFailoveretkinleştirildiğinde Linux ve macOS'ta paralelleştirilmiş SQL Server Çözümleme Protokolü istekleri. - Kimlik doğrulama sırasında sertifika iptal listesi kontrolleri düzeltildi.
- Microsoft Entra kimlik doğrulaması, null
SqlBinaryve rowversion değerleri ile UTF-8 derleme davranışı düzeltildi.
Yayınlar
| Version | Serbest bırakıldı | Müşteri açısından ilgili değişiklikler |
|---|---|---|
| 4.1.0 | Ocak 2022 | Genel kullanıma sunulma sürümü. |
| 4.1.1 | Eylül 2022 | Sertifika iptal listesiyle ilgili hatalar düzeltildi, MultiSubnetFailover için SQL Server Çözümleme Protokolü istekleri paralelleştirildi ve Microsoft Entra kimlik doğrulaması, rowversion, UTF-8 ve SNI uygulama etki alanıyla ilgili hatalar düzeltildi. |
4,0
Sürüm 4.0, Kasım 2021'de genel kullanıma ulaştı. Son yama, Ağustos 2024'te çıkan 4.0.6 idi.
- Varsayılan değeri
Encrypt'denfalse'yetruedeğiştirildi. - Birçok parametreli komutlar için eklendi
SqlCommand.EnableOptimizedParameterBinding. - Windows için .NET Standard uygulaması aracılığıyla
SqlFileStreamdesteği eklendi. - Yönetilen SNI'da paylaşılan LocalDB örneği desteği eklendi.
-
XmlReader,TextReaderveStreamiçinGetFieldValue<T>veGetFieldValueAsync<T>eklendi. - Güvenlik anahtarını yapılandırmalı yeniden deneme mantığından kaldırdım. Yeniden deneme, bir uygulama bir sağlayıcı yapılandırana kadar devre dışı kaldı.
- Microsoft Entra kimlik doğrulama başarısızlıkları,
AggregateExceptionyerineSqlExceptionfırlatacak şekilde değiştirildi. - .NET Core 2.1 kaldırıldı.
- Sürüm 4.0.5, CVE-2024-0056 şifreleme aşağı seviye yolunu ve sertifika zinciri doğrulamasını düzeltti.
Important
Şifreleme true varsayılan olarak 4.0 ve sonraki sürümlerde olduğundan, bir yükseltme sertifika güveni veya sunucu adı uyumsuzluklarını ortaya çıkarabilir. Bu hataları aşmak için şifrelemeyi devre dışı bırakmayın. Güvenilir bir sunucu sertifikası kurun veya dağıtım için sertifika doğrulamasını yapılandırın.
Yayınlar
| Version | Serbest bırakıldı | Müşteri açısından ilgili değişiklikler |
|---|---|---|
| 4.0.0 | Kasım 2021 | Genel kullanıma sunulma sürümü. |
| 4.0.1 | Ocak 2022 |
SuppressInsecureTLSWarning eklendi ve .NET 6 Kerberos, LocalDB işlem hattı adları ve eşzamanlı enclave sorgularıyla ilgili sorunlar düzeltildi. |
| 4.0.2 | Eylül 2022 | Sertifika iptal listesiyle ilgili hatalar düzeltildi, MultiSubnetFailover için SQL Server Çözümleme Protokolü istekleri paralelleştirildi ve Microsoft Entra kimlik doğrulaması, rowversion, UTF-8 ve SNI uygulama etki alanıyla ilgili hatalar düzeltildi. |
| 4.0.3 | Nisan 2023 | Önbelleğe alınmış hesap belirteçlerine uygulanan kısıtlama azaltıldı ve büyük sorgularla ilgili TDS RPC hataları düzeltildi. |
| 4.0.4 | Ekim 2023 | Asenkron enclave denemeleri, LocalDB ve yönetilen SNI yedek geri dönüşleri, dosya sürümleri ve bağlantı aktivite korelasyonu düzeltildi. |
| 4.0.5 | Ocak 2024 | CVE-2024-0056 ve sertifika zinciri doğrulamasıyla ilgili sorunlar giderildi. |
| 4.0.6 | Ağustos 2024 | Havuzlamadan önce işlem olayı temizliği ve ActiveDirectoryAuthenticationProvider.AcquireTokenAsync zaman aşımını işleme düzeltildi. |
3.1
Sürüm 3.1, Mart 2022'de genel kullanıma ulaştı. Son yama ise 3.1.7 idi ve Ağustos 2024'te yayımlandı.
- VBS yerleşkeleri için eklendi
Attestation Protocol=None. - SQL hataları 42108 ve 42109 varsayılan geçici hata listesine eklendi.
- 3.1.2'de .NET Framework için Windows ARM64 desteği eklendi.
- 3.1.3'te sessiz token edinimiyle tekrarlanan Microsoft Entra token talepleri azaltıldı.
- 3.1.5'te CVE-2024-0056 şifreleme aşağı indirme yolu düzeltildi.
- 3.1.7'de havuzlama öncesi işlem temizliği ve Microsoft Entra token zaman aşımı işlemesi düzeltildi.
Yayınlar
| Version | Serbest bırakıldı | Müşteri açısından ilgili değişiklikler |
|---|---|---|
| 3.1.0 | Mart 2022 | Genel kullanıma sunulma sürümü. |
| 3.1.1 | Ağustos 2022 | Null SqlBinaryrowversion değerleri, .NET 6 Kerberos hataları ve Microsoft Entra kimlik doğrulamasındaki null başvuru hataları düzeltildi. |
| 3.1.2 | Şubat 2023 | .NET Framework Windows ARM64 desteği eklendi ve yeniden deneme listesindeki iş parçacığı güvenliği sorunları, dağıtık işlem kilitlenmeleri, UTF-8 harmanlaması ve saklı yordam doğrulamasıyla ilgili sorunlar düzeltildi. |
| 3.1.3 | Mart 2023 |
AcquireTokenSilent ile Microsoft Entra belirteç kısıtlaması azaltıldı ve büyük sorgulardaki TDS RPC hataları düzeltildi. |
| 3.1.4 | Ekim 2023 | Asenkron enclave tekrarları, LocalDB ve yönetilen SNI yedek geri dönüşleri, dosya sürümleri, bağlantı aktivitesi korelasyonu ve EventSource biçimlendirmesi düzeltildi. |
| 3.1.5 | Ocak 2024 | CVE-2024-0056 ve sertifika zinciri doğrulamasıyla ilgili sorunlar giderildi. |
| 3.1.6 | Ağustos 2024 | Bu paket düzgün imzalanmamış ve listede yoktu. Upstream sürüm notu dosyası bulunmuyor. Bunun yerine 3.1.7 kullanın. |
| 3.1.7 | Ağustos 2024 | Havuzlamadan önce işlem olaylarının temizlenmesi, kimlik doğrulama zaman aşımları, derleme imzalama ve SNI uygulama etki alanı çökmesiyle ilgili sorunlar düzeltildi. |
3.0
Sürüm 3.0, Haziran 2021'de genel kullanıma sunuldu. Son yama ise Eylül 2021'de yayımlanan 3.0.1 idi.
- Bağlantı ve komut işlemleri için yapılandırılabilir yeniden deneme mantığı eklendi. 3.0'da,
Switch.Microsoft.Data.SqlClient.EnableRetryLogicarkasında isteğe bağlı olarak kaldı. - Bağlantı ve havuz aktivitesi için EventCounters eklendi.
-
Azure.IdentityaracılığıylaActive Directory Defaultkimlik doğrulama eklendi. - Bağlantı kapsamlı ve komut kapsamlı Always Encrypted anahtar deposu sağlayıcısı kaydı eklendi.
- TCP IP adresi tercihi eklendi.
- Kullanıcı tarafından atanan yönetilen kimlik doğrulaması,
User Idiçinde nesne kimliği yerine istemci kimliğini kullanacak şekilde değiştirildi. - SQL rowversion null değerlerini boş bayt dizisi yerine return
DBNullolarak değiştirdim. AppContext anahtarı eski davranışın korunmasını sağladı. - Minimum .NET Framework hedefi 4.6'dan 4.6.1'e yükseltildi.
3.0'dan itibaren, sistem anahtarı deposu sağlayıcıları, bir bağlantı veya komutta kayıtlı sağlayıcılara göre öncelik kazanır. Özel sağlayıcının adı dahili bir sağlayıcıyla çakışırsa yeniden adlandırın.
Yayınlar
| Version | Serbest bırakıldı | Müşteri açısından ilgili değişiklikler |
|---|---|---|
| 3.0.0 | Haziran 2021 | Genel kullanıma sunulma sürümü. |
| 3.0.1 | Eylül 2021 | Microsoft Entra bağlantılarının açılmasını engelleyen, işlem yükseltme durumu, zorunlu şifreleme, yeniden deneme özyinelemesi, kilitlenmeler ve kullanılamaz bağlantılarla ilgili sorunlar düzeltildi. |
2.1
Sürüm 2.1, Kasım 2020'de genel kullanıma ulaştı. Son yama, Ocak 2024'te yayımlanan 2.1.7 idi.
- Always Encrypted desteği, desteklenen .NET Standard 2.0 platformlarına genişletildi.
- Unix'te .NET Core ve .NET Standard 2.1 platformları boyunca güvenli enclave desteği eklendi.
- Kimlik doğrulaması eklendi
Active Directory Device Code Flowve yönetildi. - Etkileşimli ve cihaz kodu kimlik doğrulaması için özelleştirme kancaları eklendi.
- Duyarlılık sınıflandırma sıralama meta verileri eklendi.
-
SqlConnection.ServerProcessIdeklendi. - Bağlantı tarafından oluşturulan komutlar için varsayılan olarak bağlantı seçeneği eklendi
Command Timeout. - 2.1.7 sürümü, CVE-2024-0056 şifreleme aşağı indirme yolunu düzeltti.
Yayınlar
| Version | Serbest bırakıldı | Müşteri açısından ilgili değişiklikler |
|---|---|---|
| 2.1.0 | Kasım 2020 | Genel kullanıma sunulma sürümü. |
| 2.1.1 | Aralık 2020 | Azure İşlevleri, Unix Kerberos ve TCP keep-alive'de sistem tarafından atanan yönetilen kimlik düzeltildi. |
| 2.1.2 | Mart 2021 | Unix adlandırılmış örnekler, zaman aşımı hatalı sonuçlar, güvenli olmayan DTD işleme, Kerberos SPN'leri, eksik önbellek bağımlılıkları, takip ve MARS başlıkları düzeltildi. |
| 2.1.3 | Mayıs 2021 | Açık sonuç kümeleriyle işlem verilerinin bozulmasını önledi ve SinglePhaseCommit ile TransactionEnded arasındaki bir yarış durumunu giderdi. |
| 2.1.4 | Eylül 2021 | Şifreleme gerektiğinde bağlantıların başarısız olması sağlandı ve kullanılamaz duruma geçen bağlantılar düzeltildi. |
| 2.1.5 | Ağustos 2022 | Saklı yordam CommandText uzunluk doğrulaması eklendi ve .NET 6 Kerberos kimlik doğrulaması ile SqlTypeWorkarounds düzeltildi. |
| 2.1.6 | Nisan 2023 |
SqlCommand.ExecuteReaderAsync büyük sorgulardaki TDS RPC hataları, varsayılan UTF-8 karşılaştırma çakışmaları ve attention gönderimi sırasındaki kilitlenmeler düzeltildi. |
| 2.1.7 | Ocak 2024 | CVE-2024-0056 ve sertifika zinciri doğrulamasıyla ilgili sorunlar giderildi. |
2.0
Sürüm 2.0, Haziran 2020'de genel kullanıma sunuldu. Son yama ise Ağustos 2020'de yayımlanan 2.0.1 idi.
- .NET Core ve .NET Standard'da kimlik doğrulaması eklendi
Active Directory IntegratedActive Directory Interactive. -
Active Directory Service Principalkimlik doğrulama eklendi. -
Microsoft.Data.SqlClient.EventSourceizleme eklendi. - Test ve hata ayıklama için Windows'ta platformlar arası TCP keep alive ve isteğe bağlı yönetilen ağ uygulaması eklendi. Yönetilen yol, alan dışı Windows authentication'ı desteklemiyordu.
-
SqlBulkCopy.RowsCopiedeklendi ve toplu kopyalama ipuçları sıralandı. -
SqlConnection.Open(SqlConnectionOverrides.OpenWithoutRetry)eklendi. -
Microsoft.Data.SqlClient.SNI.runtimebağımlılığı aracılığıyla Windows ARM desteği eklendi. - Sunucu şifrelemeyi zorunlu kıldığında, bağlantı dizesinde
Encrypt=falseayarlandığı durumlar da dahil olmak üzere, sunucu sertifikası doğrulanmaya başlandı. Bu yükseltmeden sonra sertifika güvenilmezse veya adı sunucuyla eşleşmezse bağlantılar arızalanabilir. - Ondalık parametre ölçeklendirme işlemesi SQL Server uyumlu yuvarlama kullanılacak şekilde değiştirildi.
Yayınlar
| Version | Serbest bırakıldı | Müşteri açısından ilgili değişiklikler |
|---|---|---|
| 2.0.0 | Haziran 2020 | Genel kullanıma sunulma sürümü. |
| 2.0.1 | Ağustos 2020 | Bir arada çalışmaya uygun kimlik doğrulama yapılandırması eklendi; havuzlanmış belirteç süresinin dolması, geçici hata işleme, enclave önbellekleme ve yerel SNI prelogin hataları düzeltildi. |
1.1
Sürüm 1.1, Kasım 2019'da genel kullanıma sunuldu. Son yama ise Mart 2021'de yayımlanan 1.1.4'tü.
- Desteklenen .NET Framework ve .NET Core hedeflerine, güvenli enklavlar içeren Always Encrypted desteği eklendi.
- .NET Core’da
|DataDirectory|içindeAttachDBFilenamegenişletmesi eklendi. - Çok paketli hedef arabellek önbelleklemesiyle geliştirilmiş asenkron okuma.
-
TdsParserStateObjectveSqlDataReaderiçinde anlık görüntü ek yükü azaltıldı. - Sonraki yamalarda zaman aşımı durumu ve Çoklu Aktif Sonuç Setleri (MARS) başlık hataları düzeltildi.
Yayınlar
| Version | Serbest bırakıldı | Müşteri açısından ilgili değişiklikler |
|---|---|---|
| 1.1.0 | 2019 Kasım | Genel kullanıma sunulma sürümü. |
| 1.1.1 | Şubat 2020 | Kilitlenmelere neden olan asenkron SNIPacket değişiklikleri geri alındı ve SNI bağımlılık aralığı düzeltildi. |
| 1.1.2 | Nisan 2020 | Active Directory Etkileşimli kimlik doğrulama için kullanıcı adları eklendi ve şifre kalıcılığı ile MARS TDS başlıkları düzeltildi. |
| 1.1.3 | Mayıs 2020 | İptal edilen işlemlerin bağlantı havuzundaki bağlantıları işleme dahil etmesini engelledi ve gerilemeye neden olan MARS üstbilgisi düzeltmesini geri aldı. |
| 1.1.4 | Mart 2021 | .NET Framework 4.8 ve sonraki sürümlerde zaman aşımı durumu kaynaklı yanlış sonuçlar ve MARS üst bilgisi hataları düzeltildi. |
1.0
Microsoft. Data.SqlClient 1.0, Ağustos 2019'da genel erişilebilirliğe ulaştı. Son yama 1.0.19269.1 idi ve Eylül 2019'da yayımlandı.
- Ayrı olarak sunulan
Microsoft.Data.SqlClientsağlayıcısı tanıtıldı. - .NET Framework 4.6 ve daha sonraki sürümleri, .NET Core 2.1 ve sonraki sürümleri ve .NET Standard 2.0'ı destekledi.
- .NET Framework'te kimlik doğrulama eklendi
Active Directory Interactive. - .NET Core'da kimlik doğrulaması eklendi
Active Directory Password. -
SqlDataReaderüzerine veri hassasiyeti sınıflandırması meta verileri eklendi. - SQL Server 2019 UTF-8 derleme desteği eklendi.
- .NET Core'da Always Encrypted desteği eklendi.
Yayınlar
| Version | Serbest bırakıldı | Müşteri açısından ilgili değişiklikler |
|---|---|---|
| 1.0.19239.1 | Ağustos 2019 | Genel kullanıma sunulma sürümü. İşlem hatalarından sonra bağlantının yeniden kullanılması, SNI yayımlama, globalization-invariant işleme ve toplu kopyalamada null genişletme düzeltildi. |
| 1.0.19249.1 | Eylül 2019 | Unix'te büyük çok paketli veri okuma işlemleri düzeltildi. |
| 1.0.19269.1 | Eylül 2019 |
SqlCommand.StatementCompleted geri yüklendi, eksik SqlConnectionStringBuilder.Authentication eklendi ve uyumsuz bir SqlAuthenticationParameters.Resource API değişikliği geri alındı. |
Eski sağlayıcıdan geçiş yapan bir uygulama için, yalnızca sürüm notlarını okumak yerine System.Data.SqlClient'tan Microsoft.Data.SqlClient'e Geçiş bölümünü kullanın.
İsteğe bağlı paket sürüm notları
İsteğe bağlı paketlerin kendi sürüm notları vardır. 7.0.2 sürümünden itibaren ana sürücüyle uyumlu sürümler sunuluyor.
| Package | Sürüm notları |
|---|---|
Microsoft.Data.SqlClient.Extensions.Azure |
Azure uzantısı sürüm notları |
Microsoft.Data.SqlClient.Extensions.Abstractions |
Uzantı soyutlamaları sürüm notları |
Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider |
Azure Key Vault Provider sürüm notları |
Microsoft.Data.SqlClient.Internal.Logging öğesine doğrudan başvurmayın. Bu, sürücü paketleri tarafından paylaşılan dahili bir bağımlılıktır.
Bir güncellemeyi değerlendirin
- Doğrudan veya geçişli olarak kullanılan her sürücü ve isteğe bağlı paket versiyonunu belirleyin.
- Güncelleme sırasında geçilen her minör ve ana sürümün sürüm notlarını okuyun.
- Hedef çerçeve ve veritabanı uyumluluğu için SqlClient sürücü destek yaşam döngüsünü kontrol edin.
- Tüm ilgili paketleri uyumlu sürümlere güncelleyin.
- Uygulamanın kimlik doğrulama, şifreleme, bağlantı havuzu, parametreler, işlemler, denemeler, teşhis ve dağıtım çıktısını oluşturun ve test edin.
Kurulum ve dağıtım komutları için bkz. Microsoft'u Yükle, Güncelleme ve Dağıt. Data.SqlClient.