Instal, perbarui, dan sebarkan Microsoft. Data.SqlClient

Microsoft. Data.SqlClient adalah penyedia data .NET yang didukung untuk SQL Server, Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics, database SQL di Microsoft Fabric, dan Gudang di Microsoft Fabric. Driver tersedia sebagai paket NuGet secara terpisah dari runtime .NET.

Pilih rilis

Gunakan rilis Ketersediaan Umum (GA) yang didukung untuk aplikasi produksi. Rilis GA terbaru adalah Microsoft.Data.SqlClient 7.1.0.

Lini rilis	Versi terbaru	Tingkat dukungan	Pilih saat
7.1	7.1.0	Dukungan Jangka Waktu Standar (STS)	Anda membutuhkan fitur driver terbaru dan dapat memperbarui dengan ritme rilis reguler.
7.0	7.0.3	Dukungan Jangka Waktu Standar (STS)	Anda memerlukan perbaikan servicing saat mempersiapkan upgrade sebelum dukungan berakhir pada 17 Desember 2026.
6.1	6.1.7	Dukungan Jangka Panjang (LTS)	Anda lebih suka periode dukungan yang lebih lama dan tidak perlu fitur yang diperkenalkan di 7.x.

Untuk versi patch terbaru, tanggal dukungan, framework target, dan kompatibilitas database, lihat siklus hidup dukungan driver SqlClient.

Instal paket utama

Jalankan perintah berikut dari direktori yang berisi file proyek Anda:

dotnet add package Microsoft.Data.SqlClient

Perintah ini memilih versi stabil terbaru yang kompatibel dengan proyek. Untuk menetapkan versi agar build dapat direproduksi, tentukan versinya:

dotnet add package Microsoft.Data.SqlClient --version <version>

Pulihkan ketergantungan dan bangun proyek:

dotnet restore
dotnet build

Impor namespace driver ke C#:

using Microsoft.Data.SqlClient;

Untuk aplikasi baru, jangan merujuk pada paket atau namespace yang lebih lama System.Data.SqlClient . Untuk memperbarui aplikasi yang sudah ada, lihat Migrasi dari System.Data.SqlClient ke Microsoft. Data.SqlClient.

Instal dengan Visual Studio

Di Penjelajah Solusi, klik kanan proyek, lalu pilih Kelola Paket NuGet.
Pada tab Telusuri, cari .Microsoft.Data.SqlClient
Pilih paket yang dimiliki oleh Microsoft.
Pilih versi stabil yang didukung, lalu pilih Instal.

Untuk informasi lebih lanjut, lihat Instal dan kelola paket di Visual Studio.

Tambahkan paket opsional

Instal paket opsional hanya ketika aplikasi Anda menggunakan fitur terkait.

Package	Tambahkan itu saat
`Microsoft.Data.SqlClient.Extensions.Azure`	Microsoft. Data.SqlClient 7.0 atau versi lebih baru menggunakan mode autentikasi Microsoft Entra yang disediakan oleh driver, seperti `Direktori Aktif Default`, `Direktori Aktif Interactive`, atau `Direktori Aktif Managed Identity`.
`Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider`	Always Encrypted menyimpan kunci master kolom di Azure Key Vault.

Untuk autentikasi Microsoft Entra dengan SqlClient 7.0 atau lebih baru, jalankan:

dotnet add package Microsoft.Data.SqlClient.Extensions.Azure --version <same-version-as-Microsoft.Data.SqlClient>

Paket inti 7.0 tidak lagi mencakup ketergantungan Azure Identity. Mulai dari versi 7.0.2, driver inti dan paket pendamping menggunakan versi yang diselaraskan. Referensikan versi yang sama dari Microsoft.Data.SqlClient dan Microsoft.Data.SqlClient.Extensions.Azure. Aplikasi yang tidak menggunakan otentikasi Microsoft Entra yang disediakan oleh driver tidak memerlukan paket ekstensi Azure. Untuk pengaturan autentikasi, lihat autentikasi Microsoft Entra.

Memperbarui driver

Sebelum memperbarui:

Baca Apa yang Baru di Microsoft. Data.SqlClient dan catatan rilis upstream untuk setiap versi yang dilewati oleh pembaruan.
Periksa referensi paket langsung dan transitif aplikasi.
```
dotnet list package --include-transitive
```

Perbarui referensi paket.

dotnet add package Microsoft.Data.SqlClient --version <version>

Pulihkan, bangun, dan jalankan pengujian aplikasi.
Uji pembentukan koneksi, autentikasi, validasi sertifikat, pooling koneksi, konversi tipe data, transaksi, dan perilaku percobaan ulang terhadap setiap target database yang didukung.

Rilis besar dan patch dapat memerlukan perubahan aplikasi. Misalnya, versi 4.0 mengaktifkan enkripsi secara default, versi 5.0 berubah SqlConnectionStringBuilder.Encrypt dari bool ke SqlConnectionEncryptOption, dan versi 7.0 memindahkan autentikasi Microsoft Entra yang disediakan driver ke paket terpisah.

Mulai dari versi 7.0.2, versi assembly dari Microsoft.Data.SqlClient.Extensions.Azure, Microsoft.Data.SqlClient.Extensions.Abstractions, dan Microsoft.Data.SqlClient.Internal.Logging berubah dari 1.0.0.0 menjadi 7.0.0.0. Aplikasi .NET Framework harus dikompilasi ulang menggunakan paket yang sudah diselaraskan atau menambahkan binding redirect. Aplikasi pada .NET saat ini tidak terpengaruh oleh perubahan identitas assembly ini.

Pahami kerangka kerja target

Microsoft. Data.SqlClient 7.1 mendukung aplikasi pada:

.NET Framework 4.6.2 atau lebih baru di Windows.
.NET 8 atau versi yang lebih baru mendukung versi Windows, Linux, dan macOS.

Paket NuGet juga berisi aset kompatibilitas .NET Standard 2.0 untuk pustaka. Aplikasi eksekusi harus menargetkan runtime .NET atau .NET Framework yang didukung. Target .NET Standard suatu pustaka tidak berarti setiap runtime yang menggunakannya didukung.

Paket ini memulihkan dependensi yang dikelola dan native melalui NuGet. Jangan menyalin rakitan driver individual atau pustaka SQL Network Interface (SNI) asli antar aplikasi.

Bersiap untuk implementasi

Publikasikan untuk sistem operasi dan arsitektur yang sama seperti yang digunakan di lingkungan produksi. Untuk penerapan yang bergantung pada kerangka kerja:
```
dotnet publish --configuration Release
```
Untuk penerapan spesifik runtime:
```
dotnet publish --configuration Release --runtime <runtime-identifier>
```
Sebarkan output publikasi lengkap. Jangan hanya memilih Microsoft.Data.SqlClient.dll.
Pastikan target memiliki runtime .NET yang diperlukan kecuali Anda mempublikasikan aplikasi mandiri.
Uji output yang dipublikasikan pada sistem operasi dan arsitektur target.
Uji setiap mode autentikasi yang digunakan dalam produksi. Autentikasi terintegrasi, Kerberos, sertifikat, identitas terkelola, dan akses Azure Key Vault bergantung pada lingkungan penerapan.
Pindai graf dependensi yang telah diuraikan untuk mendeteksi kerentanan yang diketahui dan perbarui lini paket yang didukung saat perbaikan tersedia.

Mode yang invariant terhadap globalisasi tidak didukung. Untuk kualifikasi platform saat ini, lihat Sistem operasi yang didukung.

Instalasi paket offline

Unduh paket dan dependensinya dari NuGet.org, salin ke sumber paket internal, dan pulihkan dari sumber tersebut. Untuk build offline yang dapat diulang, pin versi paket dan pertahankan seluruh set ketergantungan.

Saran dan Komentar

Apakah halaman ini membantu?

Terakhir diperbarui pada 2026-10-17