Aracılığıyla paylaş

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şturulduğunda çıkış yapıtı bir .dacpac dosyadır. Yeni ve var olan veritabanları, SQL Veritabanı projesini .dacpac SQL Veritabanı Projeleri uzantısıyla yayımlayarak veya .dacpac komut satırı arabirimiyle yayımlayarak içindekilerle eşleşecek şekilde güncelleştirilebilir.

Dağıtım öncesi ve dağıtım sonrası betiklerinin yanı sıra veritabanı nesnelerini içeren SQL Veritabanı Projelerinin Özeti'nin ekran görüntüsü.

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ı/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ının .NET SDK (gerekli) ve AutoRest.Sql (isteğe bağlı) bağımlılıkları vardır.

.NET SDK

Proje derleme işlevselliği için .NET SDK gereklidir ve uzantı tarafından desteklenen bir sürüm algılanamazsa .NET SDK'sını yüklemeniz istenir. .NET SDK'sı Windows, macOS ve Linux için indirilebilir ve yüklenebilir.

Dotnet SDK'sının şu anda yüklü olan sürümlerini denetlemek istiyorsanız 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 zorlamak için, SQL projesini içeren klasöre birglobal.json dosyası ekleyin.

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

SQLCLR

Veritabanı projelerindeki SQLCLR nesneleri Visual Studio Code'da desteklenmez çünkü bunlar .NET Framework'e dayanır ve SQL Veritabanı Projeleri uzantısı proje 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. Geçerli çalışma alanında açık olan klasörlerdeki tüm SQL projeleri varsayılan olarak SQL Veritabanı Projeleri görünümünde kullanılabilir.

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

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

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

İlgili içerik

  • Last updated on