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çinLogDeploymentve 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 yoksa0.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
- SqlPackage Deployment History and Fast Comparison Preview — Matt Hyon
- Microsoft.SqlPackage 170.6.40-preview paketi
- SqlPackage indirme ve kurulum belgeleri
- DacFx 170.6.28-preview sürüm notları
- SqlPackage Extract başvurusu
- SqlPackage Publish başvurusu
Bu içerik işinize yaradı mı?
Benzer içerikleri kaçırmamak için YouTube ve GitHub hesaplarımı takip edin.





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?
Tekrar dağıtımlarda tam şema karşılaştırmasının atlanması, özellikle büyük veritabanlarında ciddi zaman kazandırabilir. Bu arada AI Scan repo taramasını REST API ile toplu yönetme yazınız da güzeldi: https://www.askinkilic.com.tr/ai-scan-repo-taramasini-rest-api-ile-toplu-yonetin/
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?
Tam da merak ettiğim bir konuydu, teşekkürler. Şu yazınızla birlikte okunursa daha iyi oturuyor: https://www.askinkilic.com.tr/microsoft-teams-ile-dijital-ekip-arkadaslari-gelistirme/