Aracılığıyla paylaş

SQL veritabanı projelerini kullanmaya başlama

Şunlar için geçerlidir: SQL Server 2022 (16.x) ve sonraki sürümleri Microsoft Fabric'teAzure SQL VeritabanıAzure SQL Yönetilen Örneği SQL veritabanı

SQL veritabanı 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ı projesinin geliştirme döngüsü, veritabanı geliştirmenin geliştirme için en iyi yöntem olarak bilinen sürekli tümleştirme ve sürekli dağıtım (CI/CD) iş akışlarıyla tümleştirilmesini sağlar.

Bu makalede yeni bir SQL projesi oluşturma, projeye nesne ekleme ve projeyi oluşturma ve dağıtma adımları izleniyor. Visual Studio (SQL Server Veri Araçları) yönergeleri dışında, kılavuz SDK stili SQL projelerine odaklanır.

  1. Yeni proje oluşturma
  2. Projeye nesneler ekleyin
  3. Projeyi oluştur
  4. Projeyi dağıt

Prerequisites

  • .NET 8 SDK
  • SqlPackage CLI
  • Microsoft.Build.Sql.Templates .NET şablonlarını 
# install SqlPackage CLI
dotnet tool install -g Microsoft.SqlPackage

# install Microsoft.Build.Sql.Templates
dotnet new install Microsoft.Build.Sql.Templates

Note

SQL veritabanı projesinin dağıtımını tamamlamak için Azure SQL veya SQL Server örneğine erişmeniz gerekir. Windows'da veya kapsayıcılarında SQL Server geliştirici sürümü ile ücretsiz olarak yerel olarak geliştirebilirsiniz.

1. Adım: Yeni proje oluşturma

El ile nesne eklemeden önce yeni bir SQL veritabanı projesi oluşturarak projemize başlıyoruz. Var olan bir veritabanındaki nesnelerle projeyi hemen doldurmayı sağlayan bir proje oluşturmanın, şema karşılaştırma araçlarını kullanma gibi başka yolları da vardır.

Dosya, Yeni, ardından Proje'yi seçin.

Yeni Proje iletişim kutusunda, arama kutusunda SQL Server terimini kullanın. En üstteki sonuç SQL Server Veritabanı Projesiolmalıdır.

Yeni proje iletişim kutusunun ekran görüntüsü.

Sonraki seçerek sonraki adıma geçin. Veritabanı adıyla eşleşmesi gerekmeyen bir proje adı girin. Proje konumunu gerektiği gibi doğrulayın ve değiştirin.

Projeyi oluşturmak için oluştur'u seçin. Boş proje açılır ve Çözüm Gezgini'nde düzenleme için görünür.

Dosya, Yeni, ardından Proje'yi seçin.

Yeni Proje iletişim kutusunda, arama kutusunda SQL Server terimini kullanın. En üstteki sonuç SQL Server Veritabanı Projesi, SDK stili (önizleme)olmalıdır.

Yeni proje iletişim kutusunun ekran görüntüsü.

Sonraki seçerek sonraki adıma geçin. Veritabanı adıyla eşleşmesi gerekmeyen bir proje adı girin. Proje konumunu gerektiği gibi doğrulayın ve değiştirin.

Projeyi oluşturmak için oluştur'u seçin. Boş proje açılır ve Çözüm Gezgini'nde düzenleme için görünür.

VS Code veya Azure Data Studio'nun Veritabanı Projeleri görünümünde Yeni Proje düğmesini seçin.

Yeni görünüm öğesinin ekran görüntüsü.

İlk istem, öncelikli olarak hedef platformun SQL Server mı yoksa Azure SQL mi olduğuna bağlı olarak hangi proje şablonunun kullanılacağını belirler. SQL'in belirli bir sürümünü seçmeniz istenirse, hedef veritabanıyla eşleşen sürümü seçin, ancak hedef veritabanı sürümü bilinmiyorsa, değer daha sonra değiştirilebileceği için en son sürümü seçin.

Görüntülenen metin girişine veritabanı adıyla eşleşmesi gerekmeyen bir proje adı girin.

Görüntülenen "Klasör Seçin" iletişim kutusunda projenin klasörü, .sqlproj dosyası ve içinde bulunabilecek diğer içerikler için bir dizin seçin.

SDK stili proje oluşturulup oluşturulmayacağı sorulduğunda evet seçin.

İşlem tamamlandıktan sonra boş proje açılır ve düzenleme için Veritabanı Projeleri görünümünde görünür.

Microsoft.Build.Sql projeleri için .NET şablonları yüklüyse, komut satırından yeni bir SQL veritabanı projesi oluşturabilirsiniz. -n seçeneği projenin adını, -tp seçeneği ise proje hedef platformunu belirtir.

Tüm kullanılabilir seçenekleri görmek için -h seçeneğini kullanın.

# create a new SQL database project
dotnet new sqlproj -n MyDatabaseProject

2. Adım: Projeye nesne ekleme

Çözüm Gezgini'nde proje düğümüne sağ tıklayın ve Ekle'yi seçin, ardından Tablo'yu seçin. Tablo adını belirtebileceğiniz Yeni Öğe Ekle iletişim kutusu görüntülenir. TABLOYU SQL projesinde oluşturmak için Ekle'yi seçin.

Tablo Visual Studio tablo tasarımcısında, sütun, dizin ve diğer tablo özelliklerini ekleyebileceğiniz şablon tablo tanımıyla açılır. İlk düzenlemeleri bitirdiğinizde dosyayı kaydedin.

Yeni Öğe Ekle iletişim kutusu aracılığıyla görünümler, saklı yordamlar ve işlevler gibi daha fazla veritabanı nesnesi eklenebilir. Çözüm Gezgini proje düğümüne sağ tıklayıp Ekleve ardından istediğiniz nesne türünü seçerek iletişim kutusuna erişin. Projedeki dosyalar, Eklealtındaki Yeni Klasör seçeneği aracılığıyla klasörler halinde düzenlenebilir.

Çözüm Gezgini'ndeproje düğümüne sağ tıklayın, Ekle'yiseçin ve ardından Yeni Öğe'yiseçin. Yeni Öğe Ekle iletişim kutusu görüntülenir, Tüm Şablonları Göster ve ardından Tablo seçin. Tablo adını dosya adı olarak belirtin ve SQL projesinde tablo oluşturmak için ekle'yi seçin.

Tablo Visual Studio sorgu düzenleyicisinde, sütun, dizin ve diğer tablo özelliklerini ekleyebileceğiniz şablon tablo tanımıyla açılır. İlk düzenlemeleri bitirdiğinizde dosyayı kaydedin.

Yeni Öğe Ekle iletişim kutusu aracılığıyla görünümler, saklı yordamlar ve işlevler gibi daha fazla veritabanı nesnesi eklenebilir. Çözüm Gezgini proje düğümüne sağ tıklayıp Ekle'i seçin, ardından Tüm Şablonları Gösterseçeneği ile istediğiniz nesne türünü belirleyin ve iletişim kutusuna erişin. Projedeki dosyalar, Eklealtındaki Yeni Klasör seçeneği aracılığıyla klasörler halinde düzenlenebilir.

VS Code veya Azure Data Studio'nun Veritabanı Projeleri görünümünde proje düğümüne sağ tıklayın ve tablo ekle seçin. Görüntülenen iletişim kutusunda tablo adını belirtin.

Tablo, sütun, dizin ve diğer tablo özelliklerini ekleyebileceğiniz şablon tablo tanımıyla metin düzenleyicisinde açılır. İlk düzenlemeleri bitirdiğinizde dosyayı kaydedin.

Proje düğümündeki bağlam menüsü aracılığıyla görünümler, saklı yordamlar ve işlevler gibi daha fazla veritabanı nesnesi eklenebilir. VS Code veya Azure Data Studio'nun görünümünde Veritabanı Projeleri'nde proje düğümüne sağ tıklayıp istediğiniz nesne türüne tıklayarak iletişim kutusuna erişin. Projedeki dosyalar, Eklealtındaki Yeni Klasör seçeneği aracılığıyla klasörler halinde düzenlenebilir.

Dosyalar proje dizininde veya iç içe klasörlerde oluşturularak projeye eklenebilir. Dosya uzantısının .sql olması ve nesne türüne veya şemaya ve nesne türüne göre düzenlenmesi önerilir.

Bir tablonun temel şablonu, projede yeni bir tablo nesnesi oluşturmak için başlangıç noktası olarak kullanılabilir:

CREATE TABLE [dbo].[Table1]
(
    [Id] INT NOT NULL PRIMARY KEY
);

3. Adım: Projeyi oluşturma

Derleme işlemi, nesneler arasındaki ilişkileri ve söz dizimini proje dosyasında belirtilen hedef platforma göre doğrular. Derleme işleminden alınan yapıt çıkışı, projeyi hedef veritabanına dağıtmak için kullanılabilen ve veritabanı şemasının derlenmiş modelini içeren bir .dacpac dosyasıdır.

Çözüm Gezginibölümünde proje düğümüne sağ tıklayın ve Derlemeseçin.

Derleme işlemini görüntülemek için çıkış penceresi otomatik olarak açılır. Hatalar veya uyarılar varsa, bunlar çıkış penceresinde görüntülenir. Başarılı bir derlemede, derleme yapıtı (.dacpac dosyası) oluşturulur ve konumu derleme çıkışına eklenir (varsayılan değer bin\Debug\projectname.dacpac).

Çözüm Gezginibölümünde proje düğümüne sağ tıklayın ve Derlemeseçin.

Derleme işlemini görüntülemek için çıkış penceresi otomatik olarak açılır. Hatalar veya uyarılar varsa, bunlar çıkış penceresinde görüntülenir. Başarılı bir derlemede, derleme yapıtı (.dacpac dosyası) oluşturulur ve konumu derleme çıkışına eklenir (varsayılan değer bin\Debug\projectname.dacpac).

VS Code veya Azure Data Studio'nun Veritabanı Projeleri görünümünde proje düğümüne sağ tıklayın ve Derlemeseçin.

Derleme işlemini görüntülemek için çıkış penceresi otomatik olarak açılır. Hatalar veya uyarılar varsa, bunlar çıkış penceresinde görüntülenir. Başarılı bir derlemede, derleme yapıtı (.dacpac dosyası) oluşturulur ve konumu derleme çıkışına eklenir (varsayılan değer bin/Debug/projectname.dacpac).

SQL veritabanı projeleri, dotnet build komutu kullanılarak komut satırından oluşturulabilir.

dotnet build

# optionally specify the project file
dotnet build MyDatabaseProject.sqlproj

Derleme çıktısı, hataları veya uyarıları ve bunların oluştuğu belirli dosyaları ve satır numaralarını içerir. Başarılı bir derlemede, derleme yapıtı (.dacpac dosyası) oluşturulur ve konumu derleme çıkışına eklenir (varsayılan değer bin/Debug/projectname.dacpac).

4. Adım: Projeyi dağıtma

.dacpac dosyasındaki bir veritabanı şemasının derlenmiş modeli, SqlPackage komut satırı aracı veya diğer dağıtım araçları kullanılarak hedef veritabanına dağıtılabilir. Dağıtım işlemi, hedef veritabanını .dacpactanımlanan şemayla eşleşecek şekilde güncelleştirmek için gerekli adımları belirler ve veritabanında zaten var olan nesnelere göre nesneleri oluşturur veya değiştirir. Sonuç olarak, dağıtım işlemi idempotenttir, yani sorunlara neden olmadan birden çok kez çalıştırılabilir ve durumlarını önceden belirlemeye gerek kalmadan aynı .dacpac'i birden fazla veritabanına dağıtabilirsiniz.

Çözüm Gezginibölümünde proje düğümüne sağ tıklayın ve Yayımla... seçin.

yayımla iletişim kutusu açılır ve burada hedef veritabanı bağlantısını kurarsınız. Dağıtım için mevcut bir SQL örneğiniz yoksa, Visual Studio ile Birlikte LocalDB ((localdb)\MSSQLLocalDB) yüklenir ve test ve geliştirme için kullanılabilir.

Bir veritabanı adı belirtin ve projeyi hedef veritabanına dağıtmak için Yayımla'ı seçin veya yürütmeden önce gözden geçirmek üzere bir betik oluşturmak için Betik Oluştur’ü seçin.

Çözüm Gezginibölümünde proje düğümüne sağ tıklayın ve Yayımla... seçin.

yayımla iletişim kutusu açılır ve burada hedef veritabanı bağlantısını kurarsınız. Dağıtım için mevcut bir SQL örneğiniz yoksa, Visual Studio ile Birlikte LocalDB ((localdb)\MSSQLLocalDB) yüklenir ve test ve geliştirme için kullanılabilir.

Bir veritabanı adı belirtin ve projeyi hedef veritabanına dağıtmak için Yayımla'ı seçin veya yürütmeden önce gözden geçirmek üzere bir betik oluşturmak için Betik Oluştur’ü seçin.

VS Code veya Azure Data Studio'nun Veritabanı Projeleri görünümünde proje düğümüne sağ tıklayın ve Yayımlaöğesini seçin.

Tip

Dağıtım için kullanılabilir bir SQL örneğiniz yoksa, SQL Veritabanı Projeleri uzantısı yeni bir kapsayıcıda sizin için yerel bir SQL Server örneği oluşturabilir. Docker Desktop çalışırken, açılır listeden yerel geliştirme için yeni bir SQL sunucusu kapsayıcısına yayınla seçeneğini seçin.

Dağıtım için mevcut bir SQL örneğiniz varsa, Mevcut bir SQL sunucusuna yayımla seçeneğini seçin ve ardından Yayımlama profili istenirse profil kullanmayın.

Hedef veritabanına bağlantı yapılandırmadıysanız, yeni bir bağlantı oluşturmanız istenir. Yeni bağlantı girişleri sunucu adını, kimlik doğrulama yöntemini ve veritabanı adını ister.

Bağlantı yapılandırıldıktan sonra dağıtım işlemi başlar. Uygulamaya almayı (yayımlamayı) otomatik olarak gerçekleştirmeyi veya yürütmeden önce gözden geçirmek için bir betik oluşturmayı seçebilirsiniz.

SqlPackage CLI, .dacpac dosyasını yayımlama eylemiyle hedef veritabanına dağıtmak için kullanılır.

Örneğin, bir .dacpac dosyasını bağlantı dizesini temel alan bir hedef veritabanına dağıtmak için:

sqlpackage /Action:Publish /SourceFile:bin/Debug/projectname.dacpac /TargetConnectionString:{yourconnectionstring}

Yardım alın

İlgili içerik

  • Last updated on