SQL Veritabanı Projeleri uzantısı

Önemli

Azure Data Studio 28 Şubat 2026 tarihindekullanımdan kaldırılıyor. Visual Studio Codekullanmanızı öneririz. Visual Studio Code'a geçiş hakkında daha fazla bilgi için Azure Data Studio'ya neler oluyor? adresini ziyaret edin.

SQL Veritabanı Projeleri uzantısı, proje tabanlı geliştirme ortamında SQL veritabanları geliştirmeye yönelik bir Visual Studio Code uzantısıdır. Uyumlu veritabanları arasında SQL Server, Azure SQL Veritabanı, Azure SQL Yönetilen Örneği, Fabric üzerinde Veri Ambarı ve Fabric üzerinde SQL Veritabanı bulunmaktadır. SQL projesi, tablolar, saklı yordamlar veya işlevler gibi tek bir veritabanının şemasını oluşturan SQL nesnelerinin yerel bir gösterimidir. SQL Veritabanı projesi oluşturduğunuzda bir .dacpac dosya oluşturursunuz. SQL Veritabanı projesini SQL Veritabanı Projeleri uzantısıyla yayımlayarak veya .dacpac komut satırı arabirimiyle yayımlayarak yeni ve mevcut veritabanlarını .dacpac içindekilerle eşleşecek şekilde güncelleştirebilirsiniz.

SQL projeleri kavramları hakkında daha fazla bilgi için bkz. SQL veritabanı projeleri nedir?

Uzantı özellikleri

SQL Veritabanı Projeleri uzantısı aşağıdaki özellikleri sağlar:

• Yeni boş bir Microsoft.Build.Sql projesi oluşturun.
• Bağlı veritabanından yeni bir proje oluşturun.
• Daha önce Visual Studio Code'da veya SQL Server Veri Araçları'nda oluşturulmuş bir projeyi açın.
• Projedeki nesneleri (tablolar, görünümler, saklı yordamlar) veya özel betikleri ekleyerek veya kaldırarak projeyi düzenleyin.
• Dosyaları ve betikleri klasörler halinde düzenleyin.
• Sistem veritabanlarına veya kullanıcı dacpac dosyasına referanslar ekleyin.
• Tek bir proje oluşturun.
• Tek bir projeyi dağıt.
• Dağıtım profilinden bağlantı ayrıntılarını (SQL Windows kimlik doğrulaması) ve SQLCMD değişkenlerini yükleyin.

Install

VISUAL Studio Code'da SQL Veritabanı Projesi uzantısını yükleyebilirsiniz.

SQL Veritabanı Projeleri uzantısı, Visual Studio Code için mssql uzantısıyla birlikte yüklenir.

Bağımlılıklar

SQL Veritabanı Projeleri uzantısı .NET SDK'sı (gerekli) ve AutoRest.Sql'e (isteğe bağlı) bağlıdır.

.NET SDK

Uzantı, proje derleme işlevselliği için .NET SDK'sını gerektirir. Uzantı desteklenen bir sürümü algılayamazsa .NET SDK'sını yüklemenizi ister. Windows, macOS ve Linux için .NET SDK'sını indirip yükleyebilirsiniz .

Dotnet SDK'sının şu anda yüklü olan sürümlerini denetlemek için bir terminal açın ve aşağıdaki komutu çalıştırın:

dotnet --list-sdks

.NET SDK'sını yükledikten sonra ortamınız SQL Veritabanı Projeleri uzantısını kullanmaya hazırdır.

Yaygın sorunlar

• Kaynak listesinde eksik nuget.org aşağıdaki gibi hata iletilerine neden olabilir:

  • error MSB4236: The SDK 'Microsoft.Build.Sql/0.1.9-preview' specified could not be found.

  • Unable to find package Microsoft.Build.Sql. No packages exist with this id in source(s): Microsoft Visual Studio Offline Packages

  nuget.org kaynak olarak kaydedilip kaydedilmediğini denetlemek için komut satırından komutunu çalıştırın dotnet nuget list source ve nuget.org başvuran bir [Enabled] öğenin sonuçlarını gözden geçirin. nuget.org kaynak olarak kaydedilmediyse komutunu çalıştırın dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org.

• Desteklenmeyen .NET SDK sürümleri aşağıdaki gibi hata iletilerine neden olabilir:

  • error MSB4018: The "SqlBuildTask" task failed unexpectedly.

  • error MSB4018: System.TypeInitializationException: The type initializer for 'SqlSchemaModelStaticState' threw an exception. ---> System.IO.FileNotFoundException: Could not load file or assembly 'System.Runtime, Version=4.2.2.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a'. The system cannot find the file specified. [c:\Users\ .sqlproj]_ (burada bağlantılı mevcut olmayan dosyanın eşleşmeyen kapanış köşeli ayracı vardır).

  Birden çok sürüm yüklendiğinde SQL Veritabanı Projeleri uzantısını .NET SDK'sının v6.x sürümünü kullanmaya zorlayabilirsiniz. Bunu yapmak için SQL projesini içeren klasöre birglobal.json dosyası ekleyin.

SQL projeleri derleme sorunlarını giderme hakkında daha fazla bilgi için bkz. SQL proje derlemesi sorunlarını giderme.

SQLCLR

Visual Studio Code, veritabanı projelerindeki SQLCLR nesnelerini desteklemez, çünkü bu nesneler .NET Framework'e dayanır ve SQL Veritabanı Projeleri uzantısı projeleri oluşturmak için .NET kullanır.

Workspace

SQL veritabanı projeleri, Visual Studio Code'daki bir mantıksal çalışma alanında (klasör) yer alır. Varsayılan olarak, SQL Veritabanı Projeleri görünümündeki geçerli çalışma alanında açık olan klasörlerdeki tüm SQL projelerine erişebilirsiniz.

Projeler bölmesindeki arabirim aracılığıyla bir çalışma alanına el ile proje ekleyebilir ve kaldırabilirsiniz. Gerekirse, dosyadaki .code-workspace bir çalışma alanının ayarlarını el ile düzenleyebilirsiniz.

Aşağıdaki örnek .code-workspace dosyada folders , dizi Gezgin bölmesine dahil edilen tüm klasörleri listeler. içindeki dizi, dataworkspace.excludedProjectssettings bölmesinden dışlanan tüm SQL projelerini listeler.

{
  "folders": [
    {
      "path": "."
    },
    {
      "name": "WideWorldImportersDW",
      "path": "..\\WideWorldImportersDW"
    }
  ],
  "settings": {
    "dataworkspace.excludedProjects": [
      "AdventureWorksLT.sqlproj"
    ]
  }
}

İlgili içerik

• SQL veritabanı projeleri nedir?
• SQL Veritabanı Projeleri uzantısını kullanmaya başlama
• SQL Veritabanı Projeleri uzantısıyla ilgili yardım alma