Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
SQL Server Data Tools (SSDT) adalah sekumpulan alat pengembangan di Visual Studio dengan fokus pada pembuatan database SQL Server dan database Azure SQL. Proyek SQL bergaya SDK di Visual Studio memungkinkan proyek SQL generasi berikutnya sebagai bagian dari fitur SQL Server Data Tools, gaya SDK (pratinjau) yang tersedia untuk Visual Studio 2022. Kemampuan proyek SQL meluas ke alur CI/CD, memungkinkan Anda mengotomatiskan build dan penyebaran proyek database Anda dengan SqlPackage.
Gambaran Umum
Format proyek SQL asli didasarkan pada MSBuild (.NET Framework) dan merupakan format yang digunakan oleh SQL Server Data Tools di Visual Studio. Format proyek gaya SDK didasarkan pada proyek gaya SDK baru (Microsoft.Build.Sql) dan merupakan format yang digunakan oleh ekstensi Proyek Database SQL untuk Visual Studio Code. SDK proyek Microsoft.Build.Sql lebih fleksibel daripada proyek SQL asli dan berisi fitur baru:
- Dukungan .NET 8 (lintas platform)
- Referensi paket NuGet untuk referensi database
- Pola globbing default untuk
.sqlfile dalam proyek
Visual Studio 2026 tidak mendukung proyek SQL bergaya SDK, dan proyek SQL asli adalah satu-satunya format proyek SQL yang tersedia dalam versi Visual Studio tersebut. Visual Studio 2022 adalah satu-satunya versi Visual Studio yang berisi proyek SQL bergaya SDK di komponen SQL Server Data Tools, gaya SDK (pratinjau).
Untuk informasi selengkapnya tentang proyek SQL, lihat Apa itu proyek database SQL?. Microsoft.Build.Sql SDK tersedia di GitHub dan di NuGet.org.
Instal
Peringatan
Fitur proyek SQL bergaya SDK dalam pratinjau dan penginstalan berdampingan dengan proyek SQL asli tidak didukung. Menginstal proyek SQL bergaya SDK dalam instans Visual Studio mandiri disarankan.
Untuk menginstal proyek SQL bergaya SDK di Visual Studio 2022, ikuti langkah-langkah berikut:
Unduh dan instal Visual Studio 2022 (17.12 atau yang lebih baru) dari halaman unduhan Visual Studio.
Selama penginstalan, pilih tab Komponen individual dan cari "SQL" untuk menemukan dan memilih "SQL Server Data Tools SDK-style (Pratinjau)". Memilih item ini secara otomatis memilih dependensi yang diperlukan.
Cari ".NET SDK" di tab Komponen individual dan pilih komponen ".NET SDK". Memilih item ini secara otomatis memilih dependensi yang diperlukan, termasuk runtime .NET yang didukung. Komponen .NET SDK memungkinkan dukungan untuk versi tambahan Microsoft.Build.Sql SDK di Visual Studio, yang tersedia melalui NuGet.org.
Lanjutkan penginstalan tanpa memilih beban kerja atau fitur tambahan.
Dokumentasi Visual Studio menyediakan informasi tambahan tentang memodifikasi penginstalan Visual Studio untuk memilih komponen individual.
Perilaku tak terduga dapat terjadi jika proyek SQL gaya SDK diinstal berdampingan dengan proyek SQL asli dan menginstal SDK-style SQL Server Data Tools disarankan sebagai komponen mandiri. Untuk memverifikasi komponen apa yang merupakan bagian dari penginstalan Visual Studio, gunakan menu Bantuan di Visual Studio dan pilih Tentang Microsoft Visual Studio. Beberapa pendekatan tersedia untuk menggunakan beberapa instans Visual Studio pada satu komputer:
Instal saluran rilis Visual Studio yang berbeda, seperti pratinjau Visual Studio 2022 dan Visual Studio 2022.
Instal edisi Visual Studio yang berbeda, seperti Komunitas Visual Studio dan Visual Studio Enterprise.
Instal ke direktori tertentu untuk memisahkan instans Visual Studio dari versi yang diinstal sebelumnya.
Batasan
Perbandingan penuh fungsionalitas antara alat proyek SQL tersedia di alat proyek SQL. Fitur proyek SQL bergaya SDK di Visual Studio memiliki batasan berikut:
Penginstalan berdampingan dengan proyek SQL asli tidak didukung
File proyek SQL menggunakan ekstensi
.sqlprojxalih-alih.sqlprojdi Visual Studio 17.12 pratinjau 2. Di Visual Studio 17.12 pratinjau versi 3 atau lebih baru, ekstensinya adalah.sqlproj.Objek SQLCLR tidak didukung
Antarmuka perbandingan skema tidak diaktifkan
Antarmuka perancang tabel tidak diaktifkan
Antarmuka perbandingan data tidak diaktifkan
Pengujian unit database tidak diaktifkan
Dukungan untuk proyek SQL bergaya SDK di Visual Studio dalam pratinjau dan penginstalan dari rilis pratinjau Visual Studio 2022 terbaru disarankan. Fitur proyek SQL di Visual Studio sedang dalam pengembangan aktif dan umpan balik diterima melalui Komunitas Pengembang.
Mengonversi proyek yang ada
Proyek SQL bergaya Microsoft.Build.Sql SDK dapat dibuat dari awal atau dikonversi dari proyek SQL yang ada. Konversi proyek SQL asli ke proyek Microsoft.Build.Sql dapat dilakukan tetapi membuat cadangan proyek sebelum dikonversi disarankan. Untuk mengonversi proyek SQL yang ada ke proyek gaya SDK, ikuti langkah-langkah dalam panduan cara mengonversi proyek SQL asli ke proyek gaya SDK .