En son sürümü indirme
Bu makalede, SqlPackage'ın yayımlanan sürümleri tarafından sunulan özellikler ve düzeltmeler listelenmektedir.
Bu sürüm notlarını nasıl okursunuz
Her bölümdeki Geçerli sütunun kapsamı şu şekildedir:
-
SqlPackage CLI - komut satırı eylemleri (yayımlama, içeri aktarma, dışarı aktarma, ayıklama, Parquet, tanılama, dotnet aracı)
-
MSBuild / SQL projeleri - SQL proje derlemesi (
Microsoft.Build.Sql SDK, SQL Server Veri Araçları (SSDT) tümleştirmesi)
-
DacFx API/Şema karşılaştırması -
Microsoft.SqlServer.DacFx NuGet API'leri, şema karşılaştırması
-
Platform - ScriptDom, Microsoft.Data.SqlClient, .NET desteği, sistem DACPACs, uyumluluk varsayılanları
Geçerli sürümler (170.x)
Aşağıdaki sürümler sqlpackage'ın şu anda desteklenen sürümleridir.
170.3.93 SqlPackage
Sürüm tarihi: 10 Şubat 2026
dotnet tool install -g microsoft.sqlpackage --version 170.3.93
Features
| Feature |
Details |
Şunlar için geçerlidir: |
| Deployment |
Veritabanı seçenekleri ACCELERATED_DATABASE_RECOVERY ve OPTIMIZED_LOCKING için destek eklendi. |
SqlPackage CLI; DacFx API/Şema karşılaştırması |
| Permissions |
İzin yayımlamasını EXECUTE ON EXTERNAL MODEL izinlerini kapsayacak şekilde geliştirir. |
SqlPackage CLI; DacFx API/Şema karşılaştırması |
| Platform |
DacFx kitaplığına ve SqlPackage CLI'ya .NET 10 desteği eklendi. SqlPackage dotnet tool hem .NET 8 hem de .NET 10 için kullanılabilir. |
Platform; SqlPackage CLI; DacFx API/Şema karşılaştırması |
| Platform |
DacFx kitaplığına .NET Standard 2.0 desteği eklendi. |
Platform; DacFx API/Şema karşılaştırması |
| Platform |
Microsoft.Data.SqlClient v6.1.3'e başvurur. |
Platform |
| ScriptDom |
ScriptDom 170.157.0 sürümüne güncelleştirildi. |
Platform |
| Vector |
Temel türün değiştirilmesine izin vermek için vektör sütunu desteğini genişletir. |
SqlPackage CLI; MSBuild / SQL projeleri; DacFx API/Şema karşılaştırması |
Fixes
| Feature |
Details |
Şunlar için geçerlidir: |
| Deployment |
Hedef veritabanı bir güvenlik ilkesi içerdiğinde Microsoft Fabric'teki SQL veritabanına dağıtmayla ilgili bir hata düzeltildi. |
SqlPackage CLI; DacFx API/Şema karşılaştırması |
| Export |
Dışarı aktarılan .dacpac dosyaların küçük harf yerine değerleri kullananTrue/False boole özniteliği değerleri nedeniyle XSD şema doğrulamasının başarısız olması sorunu düzeltildi.true/false
GitHub sorunu |
SqlPackage CLI |
| Import |
Adında özel karakterler bulunan bir tabloyu (, veya /gibi"$) içeri aktarma işleminin, kullanıcıyı uyarmadan verileri sessizce içeri aktaramamasına neden olan bir sorun düzeltildi.
GitHub sorunu |
SqlPackage CLI |
| Ledger |
Hesaplanmış sütuna sahip bir defter tablosu model doğrulama ve derleme sırasında bir NullReferenceException'ye neden olduğu bir sorunu düzeltildi.
GitHub sorunu |
MSBuild / SQL projeleri; DacFx API/Şema karşılaştırması |
| SQL projeleri |
Bir tabloda satır içi kümelenmiş columnstore dizin tanımıyla SQL projesi oluşturmanın söz dizimi hatasıyla başarısız olmasına neden olan bir sorun düzeltildi.
GitHub sorunu |
MSBuild / SQL projeleri |
| SQL projeleri |
Tabloda NVARCHAR(MAX) veya başka LOB türü sütunlar bulunan bir kümelenmiş columnstore dizininde, columnstore dizinlerinin vektör sütunlarıyla desteklenmediğine dair hatalı bir hata raporunu düzeltme sorunu giderildi.
GitHub sorunu |
MSBuild / SQL projeleri |
| Vector |
VECTOR_SEARCH kullanan yordamların, sütun başvurusunun çözümlenemediğine ilişkin doğrulama uyarısına neden olduğu bir sorun giderildi.
GitHub sorunu |
MSBuild / SQL projeleri; DacFx API/Şema karşılaştırması |
170.2.70 SqlPackage
Sürüm tarihi: 14 Ekim 2025
dotnet tool install -g microsoft.sqlpackage --version 170.2.70
Features
| Feature |
Details |
Şunlar için geçerlidir: |
| Dış modeller |
Azure SQL Veritabanı ve SQL Server 2025'te (17.x) içeri aktarma, dışarı aktarma, ayıklama, dağıtım ve SQL proje derlemesi için dış modeller için destek eklendi. |
SqlPackage CLI; MSBuild / SQL projeleri; DacFx API/Şema karşılaştırması |
| Dış modeller |
Yalnızca AI_GENERATE_CHUNKS ve AI_GENERATE_EMBEDDINGS işlevleri için destek eklendi. |
SqlPackage CLI; DacFx API/Şema karşılaştırması |
| JSON |
İçeri aktarma, dışarı aktarma, ayıklama, dağıtım ve SQL proje derlemesi için Azure SQL Veritabanı ve SQL Server 2025'te (17.x) JSON dizinleri desteği eklendi. |
SqlPackage CLI; MSBuild / SQL projeleri; DacFx API/Şema karşılaştırması |
| JSON |
JSON işlevleri JSON_ARRAYAGG, JSON_OBJECTAGG ve JSON_QUERY için destek eklendi. |
SqlPackage CLI; MSBuild / SQL projeleri; DacFx API/Şema karşılaştırması |
| Platform |
SqlPackage .zip derlemesi .NET SDK'sı 8.0.414'e güncelleştirildi |
Platform; SqlPackage CLI |
| Regex |
İşlev için REGEXP_LIKE destek eklendi. |
SqlPackage CLI; MSBuild / SQL projeleri; DacFx API/Şema karşılaştırması |
| ScriptDom |
ScriptDom 170.128.0 sürümüne güncelleştirildi. |
Platform |
| Vector |
Azure SQL Veritabanı ve SQL Server 2025'te (17.x) içeri aktarma, dışarı aktarma, ayıklama, dağıtım ve SQL proje derlemesi için vektör dizinleri desteği eklendi. |
SqlPackage CLI; MSBuild / SQL projeleri; DacFx API/Şema karşılaştırması |
| Vector |
Vektör veri türü desteğini SQL Server 2025'e (17.x) genişletir ve 32 bit float boyutunu belirtir. |
SqlPackage CLI; MSBuild / SQL projeleri; DacFx API/Şema karşılaştırması |
| Vector |
Vector işlevi VECTOR_SEARCHiçin destek eklendi. |
SqlPackage CLI; MSBuild / SQL projeleri; DacFx API/Şema karşılaştırması |
Fixes
| Feature |
Details |
Şunlar için geçerlidir: |
| Veri maskeleme |
Proje derlemesi sırasında tarih saat veri maskeleme işlevlerinin tanınmadığı bir sorun düzeltildi.
GitHub sorunu |
MSBuild / SQL projeleri |
| Dış modeller |
Veritabanı kapsamında bir kimlik bilgisine bağlı dış model bağımlılıklarının proje oluşturmasının başarısız olmasına neden olduğu bir sorun düzeltildi. |
MSBuild / SQL projeleri |
| JSON |
JSON dizinlerini varsayılan JSON yolu ile karşılaştırırken oluşan bir hata düzeltildi. |
DacFx API/Şema karşılaştırması; SqlPackage CLI |
| Platform |
Microsoft.Data.SqlClient v5.1.7'ye referans alır. |
Platform |
| XML |
XML sorgu yolunun (xQuery) model karşılaştırması sırasında büyük/küçük harfe duyarlı olarak değerlendirilmediği bir sorun düzeltildi. Büyük/küçük harfe duyarlı olmayan veritabanlarında bile, xQuery yolu büyük/küçük harfe duyarlıdır.
GitHub sorunu |
DacFx API/Şema karşılaştırması; SqlPackage CLI |
170.1.61 SqlPackage
Sürüm tarihi: 30 Temmuz 2025
dotnet tool install -g microsoft.sqlpackage --version 170.1.61
Features
| Feature |
Details |
Şunlar için geçerlidir: |
| Verilerin sanallaştırılması |
İçeri aktarma, dışarı aktarma, ayıklama ve yayımlama işlemlerinde Azure SQL Veritabanı için veri sanallaştırma ile ilgili nesneler için destek eklendi. |
SqlPackage CLI |
| Verilerin sanallaştırılması |
Azure Blob Depolama ve parquet dosyalarını kullanarak veritabanına veri aktarmayı sağlayan parquet dosyaları ile yayımlama önizleme özelliğine Azure SQL Veritabanı eklendi. Parquet dosyalarına veri çıkarma, Azure SQL Veritabanı'nda mevcut olmayan işlevlere bağlı olduğundan Azure SQL Veritabanı'nda kullanılamaz. |
SqlPackage CLI |
| Deployment |
ve /p:IgnorePreDeployScriptyayımlama özellikleri /p:IgnorePostDeployScript için destek eklendi. Bu özellikler varsayılan olarak false ön tanımlıdır ve etkinleştirildiğinde, dağıtım planı ilgili betiklerin göz ardı edilmesiyle sonuçlanır.
GitHub sorunu |
SqlPackage CLI; DacFx API/Şema karşılaştırması |
| Permissions |
Microsoft Fabric'te Azure SQL Veritabanı ve SQL veritabanı için izin ALTER ANY EXTERNAL MIRROR desteği eklendi. Bu izin, bir veya daha fazla yansıtılmış tablo içeren bir veritabanını dışarı aktarmak için gereklidir.
GitHub sorunu |
SqlPackage CLI; DacFx API/Şema karşılaştırması |
| Permissions |
SQL Server 2025 (17.x) için izinler CREATE ANY EXTERNAL MODEL ve ALTER ANY EXTERNAL MODEL desteği eklendi. |
SqlPackage CLI; DacFx API/Şema karşılaştırması |
| Permissions |
SQL Server 2025 (17.x) ve Azure SQL Veritabanı için izin ALTER ANY INFORMATION PROTECTION desteği eklendi. |
SqlPackage CLI; DacFx API/Şema karşılaştırması |
| Platform |
SqlPackage .zip derlemesi .NET SDK'sı 8.0.412'ye güncelleştirildi. |
Platformu; SqlPackage CLI |
| ScriptDom |
ScriptDom 170.0.64 sürümüne güncelleştirildi. |
Platform |
| ScriptDom |
Fabric platformundaki Veri ambarını ScriptDom'da kullanmak üzere TSqlFabricDWParser ile güncelleştirir. |
Platform; DacFx API/Şema karşılaştırması |
Fixes
| Feature |
Details |
Şunlar için geçerlidir: |
| Always Encrypted (Her Zaman Şifreli) |
Yayımlama parametresi seçeneğinin Interactive/AzureKeyVaultAuthMethod düzgün çalışmadığı bir sorun düzeltildi. |
SqlPackage CLI |
| Deployment |
Dağıtımda DbScopedConfigMaxDOPSecondary doğru bir şekilde ayarlanmaması sorunu giderildi.
GitHub sorunu |
SqlPackage CLI; DacFx API/Şema karşılaştırması |
| Deployment |
Yabancı anahtar kısıtlamaları içeren tabloları yayımlamanın Microsoft Fabric'teki Veri ambarında desteklenmeyen söz dizimi ile başarısız olduğu bir sorun düzeltildi. |
SqlPackage CLI |
| Deployment |
Microsoft Fabric'te SQL veritabanına dağıtılırken sunucu nesnelerinin dahil edildiği bir sorun düzeltildi. Sunucu nesneleri Microsoft Fabric'teki SQL veritabanında desteklenmez.
GitHub sorunu |
SqlPackage CLI |
| Deployment |
Clustered columnstore dizinlerinin, öncelikle kümelenmiş bir dizin oluşturarak yaratılmasına yol açan ve dağıtım yükü ile süresini artıran bir sorun giderildi.
GitHub sorunu |
SqlPackage CLI |
| Extract |
Microsoft Fabric'te SQL veritabanından veritabanı ayıklamanın kullanılamayan kullanıcı tanımı betiklerine neden olduğu bir sorun düzeltildi.
GitHub sorunu |
SqlPackage CLI |
170.0.94 SqlPackage
Çıkış Tarihi: Nisan 15, 2025
dotnet tool install -g microsoft.sqlpackage --version 170.0.94
Features
| Feature |
Details |
Şunlar için geçerlidir: |
| DACPACVerify |
.dacpac önizleme aracına, iki dosyanın içeriğini doğrulama desteği eklenmiştir. |
DacFx API/Şema karşılaştırması |
| Extract |
Bir .dacpac dosyasını bir klasöre açma desteği eklendi. Komut /Action:Extract, /SourceFile: ve /TargetFile: parametreleri ile birlikte kullanılır. Hedef dosya bir klasör olmalıdır ve bir kaynak dosya (.dacpac) belirtildiğinde hiçbir veritabanı bağlantı özelliği geçerli değildir. Bu özellik /p:ExtractTarget=SchemaObjectType , kaynak veritabanı yerine bir .dacpac dosyadan ayıklamak için gereklidir. Yürütülebilir dosya Dacunpack.exe kurulum programından DacFx.msi kaldırıldı. |
SqlPackage CLI; DacFx API/Şema karşılaştırması |
| Parquet |
SqlPackage ayıklama ve yayımlama işlemleriyle Azure Blob Depolama'da Parquet dosyaları kullanılırken zaman damgası, rowversion, uniqueidentifier, metin, ntext, görüntü, json, xml ve vektör veri türleri için destek eklendi. |
SqlPackage CLI |
| Parquet |
Tablo, desteklenmeyen bir veri türü içerdiğinde, SqlPackage ayıklama ve yayımlama işlemleri sırasında BCP dosyalarına tablo verilerini dışarı ve içeri aktarma desteği eklendi. Bu işlem, kalan veriler için Azure Blob Depolama'da Parquet dosyaları kullanılırken gerçekleştirilmektedir. Örnek veri türü sql_variant ve bu türdeki bir sütunu içeren bir tablo BCP'ye yazılırken, kalan tablolar Azure Blob Depolama'daki .dacpac Parquet dosyalarına yazılır. |
SqlPackage CLI |
| Platform |
.NET Framework için SqlPackage sürümü .NET Framework 4.7.2 olarak güncelleştirildi. |
Platform; SqlPackage CLI |
| Platform |
.NET 6 desteği kaldırıldı. |
Platform; SqlPackage CLI |
| ScriptDom |
ScriptDom 170.18.0 sürümüne güncellendi. |
Platform |
| SQL projeleri |
Microsoft Fabric'teki Azure SQL Veritabanı ve SQL veritabanı için varsayılan uyumluluk düzeyi artık 170 olarak ayarlanmıştır. Daha fazla bilgi için Azure SQL Veritabanı'nda veritabanı uyumluluk düzeyi 170'e ve Microsoft Fabric'te SQL veritabanı'na bakın. |
MSBuild / SQL projeleri |
| Vector |
Vektör veri türü artık içeri aktarma, dışarı aktarma, ayıklama, dağıtım ve SQL proje derlemesi için hedef platformda Azure SQL Database desteklenmektedir. |
SqlPackage CLI; MSBuild / SQL projeleri; DacFx API/Şema karşılaştırması |
Fixes
| Feature |
Details |
Şunlar için geçerlidir: |
| Deployment |
Dış tabloya bir değişiklik dağıtıldığında, eğer değiştirilmiş tablo REJECT_VALUE veya REJECT_SAMPLE_VALUE için herhangi bir değer içermiyorsa, tüm dış tabloların bırakılmasına ve yeniden oluşturulmasına neden olan bir sorun düzeltildi. |
SqlPackage CLI; DacFx API/Şema karşılaştırması |
| Deployment |
Değiştirilen bir sütunun uzunluğunu genişletmek, sütunun harmanlaması belirtilmişse ve veritabanının varsayılan harmanlaması ile eşleşiyorsa yanlış veri kaybı uyarısının oluşmasına neden olan bir sorunu gidermek için düzeltildi.
GitHub sorunu |
SqlPackage CLI; DacFx API/Şema karşılaştırması |
| Deployment |
Bir tablodaki duyarlılık sınıflandırması değişikliklerinin dizinlerin yeniden oluşturulmasına neden olduğu bir sorun düzeltildi.
GitHub sorunu |
SqlPackage CLI; DacFx API/Şema karşılaştırması |
| Export |
Dışarı aktarma işlemleri sırasında tablo boyutu tahmini kullanımını iyileştirdik. |
SqlPackage CLI |
| Extract |
Veritabanı referansıyla .dacpac çıkartma işleminin başarısız olmasına neden olan bir sorun düzeltildi.
GitHub sorunu |
SqlPackage CLI; DacFx API/Şema karşılaştırması |
| Kumaş Veri Ambarı |
Yayımlama işlemi sırasında sp_refreshsqlmodule sistem saklı yordamı çağrıldığında oluşan bir sorun düzeltildi. Fabric Veri Ambarı, sp_refreshsqlmodule öğesini desteklemez ve bu, dağıtımın başarısız olmasına neden olur. |
SqlPackage CLI |
| Kumaş Veri Ambarı |
Bir veritabanı Doku Veri Ambarı'ndan ayıklandığında tablo kısıtlamalarının .dacpac dosyalarına eklenip .sql dosyalarına eklenmemesi sorununu düzelttik.
GitHub sorunu |
SqlPackage CLI |
| SQL projeleri |
Visual Studio'da SSDT yüklü olmadan derlemenin yanlış derleme davranışıyla sonuçlandığı bir sorun düzeltildi.
GitHub sorunu |
MSBuild / SQL projeleri |
| SQL projeleri |
Kod analizi etkinleştirildiğinde çıkışta derleme uyarılarının yinelenmesine neden olan bir sorun düzeltildi.
GitHub sorunu |
MSBuild / SQL projeleri |
| SQL projeleri |
Hizmet aracısı parametrelerinin değişkenlere ayarlanmasının hatalı uyarılarla sonuçlandığı bir sorun düzeltildi.
GitHub sorunu |
MSBuild / SQL projeleri |
Arşivlenen sürümler (162.x ve önceki sürümler)
Sürüm 162.x ve eski sürümlerin sürüm notlarını SqlPackage sürüm notları (arşiv) bölümünde bulabilirsiniz.