SqlPackage ile Dağıtım Geçmişi ve Hızlı Karşılaştırma

SqlPackage önizlemesindeki dağıtım geçmişi ve hızlı karşılaştırma özellikleri, uygun tekrar dağıtımlarında tam şema karşılaştırmasının atlanmasını sağlayabilir. Yazı, bu özelliklerin kullanımını bir SQL Server örneğiyle anlatıyor.

SqlPackage 170.6 önizlemesindeki dağıtım geçmişi ve hızlı karşılaştırma seçenekleri, veritabanı dağıtımlarının izlenmesini ve uygun tekrar dağıtımlarında tam şema karşılaştırmasının atlanmasını sağlıyor. Bu özellikler, özellikle aynı veritabanı modelinin CI/CD hattında yeniden yayımlandığı durumlarda kullanılabiliyor.

SQL veritabanı projesi istenen şemayı tanımlar. Projenin derlenmesiyle oluşan .dacpac dosyası SqlPackage tarafından hedef veritabanıyla karşılaştırılır. Model değişmemiş olsa bile değişiklik gerekip gerekmediğini belirlemek için normalde tam şema karşılaştırması yapılabilir.

Kaynakta kullanılan örnek, Microsoft.SqlPackage paketinin 170.6.40-preview sürümünü temel alıyor. Bu pakette çalıştırılabilir dosyanın bildirdiği sürüm 170.6.40.1. Önizleme davranışı ve meta verileri değişebilir.

Dağıtım geçmişi ve hızlı karşılaştırma nasıl çalışıyor?

İki Publish özelliği de varsayılan olarak False değerinde:

  • /p:LogDeployment=True, dağıtım geçmişini hedef veritabanındaki [sqlproj].[DeploymentHistory] tablosuna kaydeder.
  • /p:EnableFastComparison=True, son dağıtım kaydıyla hızlı karşılaştırmayı etkinleştirir. Bunun için LogDeployment ve uyumlu dağıtım geçmişine sahip mevcut bir veritabanı gerekir.

Hızlı karşılaştırma açılmadan da dağıtım geçmişi tutulabilir. Böylece kayıtlar oluşturulurken normal şema karşılaştırması korunur.

İki seçenek birlikte etkinleştirildiğinde SqlPackage, hedefte uyumlu geçmiş bulunup bulunmadığını kontrol eder. Modelin sağlama toplamı ve dağıtım seçenekleri son kayıtla eşleşirse tam şema karşılaştırmasını atlayabilir. Eşleşme yoksa veya hedef yeni bir veritabanıysa normal karşılaştırma kullanılır. Uygun bir sonraki dağıtım ise hızlı yoldan yararlanabilir.

Bu mekanizma yalnızca 1.0.0 gibi bir sürüm dizesini karşılaştırmaz. Dağıtım sırasını zorunlu tutan bir geçiş sistemi veya otomatik geri alma mekanizması da değildir. Daha düşük uygulama sürümünün dağıtılmasını engelleyen bir kural içermez.

Bu iş akışında DAC kaydını dağıtım geçmişiyle birlikte kullanmayın. RegisterDataTierApplication özelliğini varsayılan değeri olan False konumunda bırakın. Hedef veritabanı zaten DAC olarak kayıtlıysa önce kaydını kaldırmak gerekir; özelliği False yapmak mevcut kaydı kaldırmaz.

Aynı modeli iki kez yayımlama örneği

Kaynak örneğinde yerel SQL Server üzerindeki AdventureWorks2025 veritabanının şeması çıkarılıp ayrı bir AdventureWorksPreview veritabanına iki kez yayımlanıyor. Kaynak veritabanı yalnızca okunuyor; yayımlama hedefi olarak kullanılmıyor ve şeması değiştirilmiyor. Çıkarma işlemi yalnızca şemayı kapsıyor, örnek veriler hedefe kopyalanmıyor.

Örnek için Windows PowerShell, SqlPackage kurulumu ve çalıştırılmasıyla uyumlu.NET SDK ve çalışma zamanı, localhost üzerinden erişilebilen bir SQL Server ve kurulu AdventureWorks2025 veritabanı gerekiyor. AdventureWorks tam metin dizinleri içerdiğinden SQL Server üzerinde Full-Text Search de kurulu olmalı. Windows kimlik doğrulamasıyla kaynak şemayı okuma, hedef veritabanını oluşturma ve şema ile dağıtım geçmişi nesnelerini dağıtma izinleri de gerekli.

Önizleme, kararlı genel kurulumu değiştirmemek için önce ayrı bir araç dizinine yüklenir:

dotnet tool install Microsoft.SqlPackage `
--tool-path.\tools\sqlpackage-preview `
--version 170.6.40-preview
if ($LASTEXITCODE -ne 0) {
throw "SqlPackage preview installation failed."
}
$sqlpackage = Join-Path $PWD "tools\sqlpackage-preview\sqlpackage.exe"
& $sqlpackage /Version
if ($LASTEXITCODE -ne 0) {
throw "Unable to run SqlPackage preview."
}

Aynı PowerShell oturumunda kaynak şema .dacpac dosyasına çıkarılır:

$server = "localhost"
$sourceDatabase = "AdventureWorks2025"
$targetDatabase = "AdventureWorksPreview"
$artifactDirectory = Join-Path $PWD "artifacts"
$dacpac = Join-Path $artifactDirectory "AdventureWorks2025.dacpac"
New-Item -ItemType Directory -Path $artifactDirectory -Force | Out-Null
$sourceConnectionString = "Server=$server;Initial Catalog=$sourceDatabase;Integrated Security=True;Encrypt=True;TrustServerCertificate=True;"
& $sqlpackage `
/Action:Extract `
"/SourceConnectionString:$sourceConnectionString" `
"/TargetFile:$dacpac" `
/p:ExtractAllTableData=False `
/p:VerifyExtraction=True
if ($LASTEXITCODE -ne 0) {
throw "AdventureWorks schema extraction failed."
}

Gerektiğinde $server veya $sourceDatabase değiştirilebilir. İşlem .\artifacts\AdventureWorks2025.dacpac dosyasını üretir. ExtractAllTableData=False kullanıldığı ve veri çıkarımı için ayrı tablolar seçilmediği için tablo verileri kopyalanmaz.

Bağlantı dizesindeki TrustServerCertificate=True yalnızca bu örnek içindir. Uzak veya üretim sunucularında uygun şekilde yapılandırılmış bir sertifika ve TrustServerCertificate=False kullanılmalıdır.

Ardından hedef bağlantısı ve yayımlama argümanları hazırlanır. Tekrar dağıtımında aynı argümanların kullanılması için iki özellik de ilk dağıtımdan itibaren etkinleştirilir:

$connectionString = "Server=$server;Initial Catalog=$targetDatabase;Integrated Security=True;Encrypt=True;TrustServerCertificate=True;"
$publishArgs = @(
"/Action:Publish"
"/SourceFile:$dacpac"
"/TargetConnectionString:$connectionString"
"/p:LogDeployment=True"
"/p:EnableFastComparison=True"
)

İlk yayımlamada yeni hedef için normal karşılaştırma yolu izlenir; hedef veritabanı oluşturulur, şema dağıtılır ve dağıtım geçmişi kaydedilir:

& $sqlpackage @publishArgs
if ($LASTEXITCODE -ne 0) {
throw "Initial database publish failed."
}

Hedef geçmişi, localhost sunucusuna bağlanan bir SQL sorgu aracıyla incelenebilir:

USE [AdventureWorksPreview];
GO
SELECT *
FROM [sqlproj].[DeploymentHistory];

Sorgu belirli sütun adlarına bağlı değildir; tablonun meta verileri önizleme sürecinde değişebilir. Tablo, uygulamanın elle değiştireceği bir tablo olarak değil, aracın yönettiği meta veri olarak ele alınmalıdır.

Dosya yeniden çıkarılmadan veya yayımlama argümanları değiştirilmeden aynı model tekrar yayımlanır:

& $sqlpackage @publishArgs
if ($LASTEXITCODE -ne 0) {
throw "Repeat database publish failed."
}

Hedefteki geçmiş uyumluysa ve modelin sağlama toplamı ile dağıtım seçenekleri son kayıtla eşleşiyorsa SqlPackage tam şema karşılaştırmasını atlayabilir. Yayımlama çıktısında şu ileti hızlı yolun seçildiğini gösterir:

Fast comparison match found, source model checksum and deployment options match last logged deployment. Database reverse engineering and deployment plan generation is skipped. Disable fast comparison to run a full model comparison.

Proje tabanlı bir hatta şema değişikliği yeni bir .dacpac üretir. Güncellenmiş modelin sağlama toplamı değişmişse geçmiş eşleşmesine dayalı kısa yol kullanılmaz; SqlPackage şema değişikliklerini belirlemek için normal karşılaştırmaya döner. İş akışı, sıralı geçiş betikleri listesi yerine istenen veritabanı modelini dağıtmaya devam eder.

Proje sürümlerini dağıtım betiklerinde kullanma

Dağıtım geçmişi, SQL veritabanı projesinde tanımlanan sürüme betiklerden başvurmak için de kullanılabilir. Bunun için projenin .sqlproj dosyasında DacVersion tanımlanır:

<PropertyGroup>
<DacVersion>1.0.0</DacVersion>
</PropertyGroup>

Proje derlenip DACPAC /p:LogDeployment=True ile yayımlandığında, desteklenen hedeflerde kaynak DACPAC sürümü dağıtım geçmişine kaydedilir. SqlPackage ayrıca dağıtım öncesi ve sonrası betiklere şu SQLCMD değişkenlerini sağlar:

  • $(DacVersion): Gelen DACPAC dosyasının sürümü.
  • $(DacVersion_Previous): Hedefte aynı proje için kaydedilmiş son sürüm. Önceki kayıt yoksa 0.0.0.

Bu değişkenler LogDeployment=False olduğunda otomatik sağlanmaz. Gelen sürüm, Publish sırasında yapılan bir sürüm geçersiz kılmasından değil, DACPAC meta verisinden alınır. Örneği hızlı karşılaştırmadan bağımsız denemek için /p:EnableFastComparison=False kullanılabilir.

Örneğin, hedefte [Code] ve [Name] sütunlarına sahip [dbo].[ReferenceData] tablosunun zaten bulunduğu varsayılsın. Sürüm 1.0.0 dağıtılırken şema değişikliklerinden önce eksik bir referans değeri eklemek için dağıtım öncesi betiğe şu koşul konabilir:

IF N'$(DacVersion)' = N'1.0.0'
BEGIN
INSERT INTO [dbo].[ReferenceData] ([Code], [Name])
SELECT N'STANDARD', N'Standard service'
WHERE NOT EXISTS
(
SELECT 1
FROM [dbo].[ReferenceData]
WHERE [Code] = N'STANDARD'
);
END;

1.0.0 sürümünde değer eksikse eklenir; aynı sürüm tekrar yayımlandığında yinelenen kayıt eklenmez. 2.0.0 yayımlandığında dağıtım geçmişe kaydedilir, ancak koşul eşleşmediği için bu ekleme çalışmaz.

Koşul gelen sürümle değil, önceden dağıtılmış sürümle ilgiliyse $(DacVersion_Previous) kullanılabilir. Bu değer canlı hedef şemanın kontrolü değil, aynı proje için kaydedilmiş son sürümdür.

Hızlı karşılaştırmanın sınırları

Geçmiş kaydı eşleşmesi, canlı veritabanının hat dışında değiştirilmediğini kanıtlamaz. Elle şema değişiklikleri mümkünse veya mevcut hedef şemanın açıkça karşılaştırılması gerekiyorsa günlükleme korunup hızlı karşılaştırma kapatılabilir:

& $sqlpackage `
/Action:Publish `
"/SourceFile:$dacpac" `
"/TargetConnectionString:$connectionString" `
/p:LogDeployment=True `
/p:EnableFastComparison=False
if ($LASTEXITCODE -ne 0) {
throw "Database publish with normal comparison failed."
}

Bu önizlemede hızlı karşılaştırma eşleşmesi, dağıtım öncesi ve sonrası betikleri de atlar. Normal karşılaştırmada ise şema değişikliği bulunmasa bile bu betikler çalışır. Bu nedenle tekrar çalıştırılmaları güvenli olacak şekilde hazırlanmalıdır.

Dağıtım geçmişi izlenebilirlik sağlar, fakat şema değişikliklerini geri almaz veya silinen verileri geri yüklemez. Mevcut yedekleme ve kurtarma süreçleri kullanılmaya devam edilmelidir. Başlangıçta yalnızca LogDeployment etkinleştirilebilir. EnableFastComparison ise şeması hat üzerinden yönetilen ve tekrar karşılaştırmalarını atlamanın uygun olduğu ortamlar için değerlendirilebilir.

Kaynaklar ve İleri Okuma

Bu yazı yapay zeka (büyük dil modelleri) ile hazırlanmış, insan editör tarafından incelenmiştir. İçerik üretim sürecimiz.
Aşkın KILIÇ

20+ yıl deneyimli Azure Solutions Architect. Microsoft sertifikalı bulut mimari ve DevOps danışmanı. Azure, yapay zekâ ve bulut teknolojileri üzerine Türkçe teknik içerikler üretiyor.

AZ-305AZ-104AZ-500AZ-400DP-203AI-102

Bu içerik işinize yaradı mı?

Benzer içerikleri kaçırmamak için YouTube ve GitHub hesaplarımı takip edin.

Haftalık Bülten

Her pazar özenle seçilmiş teknoloji yazıları doğrudan e-postanıza gelsin.

Kurumsal DevOps ve bulut dönüşümü danışmanlığı: Danışmanlık Hizmetleri

4 Yorum

  1. Tekrar dağıtımlarında tam şema karşılaştırmasının atlanması özellikle büyük veritabanlarında epey zaman kazandırabilir. Şemada dışarıdan yapılan değişiklikler varsa bunları da algılıyor mu?

  2. Tekrar dağıtımlarda tam şema karşılaştırmasını atlamak büyük veritabanlarında ciddi zaman kazandırabilir. Peki hedef veritabanında elle yapılan değişiklikler varsa hızlı karşılaştırma bunları nasıl yakalıyor?

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir

✉

Haftalık Bülten

Azure, DevOps ve Yapay Zeka dünyasındaki en güncel içerikleri her hafta doğrudan e-postanıza alın.

Spam yok. İstediğiniz zaman iptal edebilirsiniz.
📱
Uygulamayı Yükle Ana ekrana ekle, çevrimdışı oku
Kategoriler
Ara
Paylaş
WhatsApp
İçindekiler
← AI Scan Repo Taramasını REST A...
Microsoft Teams ile Dijital Ek... →
📩

Gitmeden önce!

Her pazar özenle seçilmiş teknoloji yazıları ve AI haberleri doğrudan e-postanıza gelsin. Ücretsiz, spam yok.

🔒 Bilgileriniz güvende. İstediğiniz zaman ayrılabilirsiniz.

📬 Haftalık bülten: Teknoloji + AI haberleri
Beni Takip Et Yeni Azure / AI / DevOps yazılarını GitHub ve RSS üzerinden takip edin.