Aracılığıyla paylaş


SQL Server Veri Araçları, SDK stili (önizleme)

SQL Server Veri Araçları (SSDT), Visual Studio'da SQL Server veritabanları ve Azure SQL veritabanları oluşturmaya odaklanan bir geliştirme araçları kümesidir. Visual Studio'daki SDK stili SQL projeleri, Visual Studio 2022'de kullanılabilen SQL Server Veri Araçları, SDK stili (önizleme) özelliğinin bir parçası olarak yeni nesil SQL projelerini etkinleştirir. SQL projeleri özelliği CI/CD işlem hatlarına genişletildiğinden SqlPackage ile veritabanı projelerinizin derlemesini ve dağıtımını otomatikleştirebilirsiniz.

Genel Bakış

Özgün SQL proje biçimi MSBuild (.NET Framework) tabanlıdır ve Visual Studio'da SQL Server Veri Araçları tarafından kullanılan biçimdir. SDK stili proje biçimi, yeni SDK stili projeleri (Microsoft.Build.Sql) temel alır ve Visual Studio Code için SQL Veritabanı Projeleri uzantısı tarafından kullanılan biçimdir. Microsoft.Build.Sql proje SDK'sı özgün SQL projelerinden daha esnektir ve yeni özellikler içerir:

  • .NET 8 desteği (platformlar arası)
  • Veritabanı başvuruları için NuGet paket referansları
  • Projedeki .sql dosyalar için varsayılan globbing örüntüsü

Visual Studio 2026, SDK stili SQL projelerini desteklemez ve özgün SQL projeleri, Visual Studio'nun bu sürümünde kullanılabilen tek SQL proje biçimidir. Visual Studio 2022, SQL Server Veri Araçları, SDK stili (önizleme) bileşeninde SDK stili SQL projeleri içeren tek Visual Studio sürümüdür.

SQL projeleri hakkında daha fazla bilgi için bkz. SQL veritabanı projeleri nedir?. Microsoft.Build.Sql SDK'sı GitHub'da ve NuGet.org'da kullanılabilir.

Install

Uyarı

SDK stili SQL projeleri özelliği önizleme aşamasındadır ve özgün SQL projeleri ile yan yana yükleme desteklenmez. SDK stili SQL projelerinin tek başına bir Visual Studio örneğine yüklenmesi tavsiye edilir.

Visual Studio 2022'de SDK stili sql projelerini yüklemek için şu adımları izleyin:

  1. Visual Studio indirme sayfasından Visual Studio 2022'yi (17.12 veya üzeri) indirip yükleyin.

  2. Yükleme sırasında Tek tek bileşenler sekmesini seçin ve "SQL" araması yapıp "SQL Server Veri Araçları SDK stili (Önizleme)" öğesini bulun ve seçin. Bu öğe seçildiğinde gerekli bağımlılıklar otomatik olarak seçilir.

  3. Tek tek bileşenler sekmesinde ".NET SDK" araması yapın ve ".NET SDK" bileşenini seçin. Bu öğe seçildiğinde, desteklenen .NET çalışma zamanları da dahil olmak üzere gerekli bağımlılıklar otomatik olarak seçilir. .NET SDK bileşeni, Visual Studio'da NuGet.org aracılığıyla kullanılabilen ek Microsoft.Build.Sql SDK sürümleri için destek sağlar.

    Bağımsız bileşenler sekmesinin açık olduğu Visual Studio yükleyicisinin ekran görüntüsü.

  4. İş yüklerini veya ek özellikleri seçmeden yüklemeye devam edin.

Visual Studio belgeleri , tek tek bileşenleri seçmek için Visual Studio yüklemelerini değiştirme hakkında ek bilgiler sağlar.

SDK stili SQL projeleri özgün SQL projeleriyle yan yana yüklenirse ve SDK stili SQL Server Veri Araçları'nın tek başına bileşen olarak yüklenmesi önerilirse beklenmeyen davranış oluşabilir. Visual Studio yüklemesinin parçası olan bileşenleri doğrulamak için Visual Studio'daki Yardım menüsünü kullanın ve Microsoft Visual Studio Hakkında'yı seçin. Tek bir makinede birden çok Visual Studio örneğini kullanmak için çeşitli yaklaşımlar kullanılabilir:

  • Visual Studio'nun Visual Studio 2022 ve Visual Studio 2022 önizlemesi gibi farklı yayın kanallarını yükleyin.

  • Visual Studio Community ve Visual Studio Enterprise gibi farklı Visual Studio sürümlerini yükleyin.

  • Visual Studio örneğini önceden yüklenmiş bir sürümden ayırmak için belirli bir dizine yükleyin.

Sınırlamalar

SQL projeleri araçları arasındaki işlevlerin tam karşılaştırması SQL projeleri araçlarında kullanılabilir. Visual Studio'daki SDK stili SQL projeleri özelliği aşağıdaki sınırlamalara sahiptir:

  • Özgün SQL projeleriyle yan yana yükleme desteklenmez

  • Visual Studio 17.12 önizleme 2'de, SQL proje dosyası .sqlprojx yerine .sqlproj uzantısını kullanır. Visual Studio 17.12 önizleme 3 ve sonraki sürümlerde uzantı .sqlproj'dir.

  • SQLCLR nesneleri desteklenmiyor

  • Şema karşılaştırma arabirimi etkinleştirilmedi

  • Tablo tasarımcısı arabirimi etkinleştirilmedi

  • Veri karşılaştırma arabirimi etkinleştirilmedi

  • Veritabanı birim testi etkinleştirilmedi

Visual Studio'da SDK stili SQL projeleri için destek önizleme aşamasındadır ve en son Visual Studio 2022 önizleme sürümünden yükleme önerilir. Visual Studio'daki SQL projeleri özelliği etkin geliştirme aşamasındadır ve Geliştirici Topluluğu aracılığıyla geri bildirim alabilirsiniz.

Var olan projeleri dönüştürme

Microsoft.Build.Sql SDK stili SQL projeleri sıfırdan oluşturulabilir veya mevcut SQL projelerinden dönüştürülebilir. Özgün SQL projesinin Microsoft.Build.Sql projesine dönüştürülmesi yerinde yapılabilir, ancak dönüştürmeden önce projenin yedeğinin oluşturulması önerilir. Var olan bir SQL projesini SDK stili projeye dönüştürmek için , Özgün SQL projesini SDK stili projeye dönüştürme nasıl yapılır kılavuzundaki adımları izleyin.