Stáhnout nejnovější verzi
Tento článek uvádí funkce a opravy poskytované vydanými verzemi SqlPackage.
Jak číst tyto poznámky k vydání
Sloupec Platí pro v jednotlivých oddílech je vymezený následujícím způsobem:
-
SqlPackage CLI – akce příkazového řádku (publikování, import, export, extrakce, Parquet, diagnostika, nástroj dotnet)
-
MSBuild / SQL projekty – sestavení projektu SQL (
Microsoft.Build.Sql SDK, integrace nástrojů SQL Server Data Tools (SSDT))
-
Rozhraní DacFx API / Porovnání schémat -
Microsoft.SqlServer.DacFx NuGet API, porovnání schémat
-
Platforma – ScriptDom, Microsoft.Data.SqlClient, podpora .NET, systém DACPACs, výchozí hodnoty kompatibility
Aktuální verze (170.x)
Následující verze jsou aktuálně podporované verze SqlPackage.
170.3.93 SqlPackage
Datum vydání: 10. února 2026
dotnet tool install -g microsoft.sqlpackage --version 170.3.93
Features
| Feature |
Details |
Vztahuje se na |
| Deployment |
Přidána podpora pro databázové možnosti ACCELERATED_DATABASE_RECOVERY a OPTIMIZED_LOCKING. |
SqlPackage CLI; API rozhraní DacFx / Porovnání schémat |
| Permissions |
Vylepšuje publikování oprávnění tak, aby zahrnovala EXECUTE ON EXTERNAL MODEL oprávnění. |
SqlPackage CLI; Rozhraní DACFx API / Porovnání schématu |
| Platform |
Přidání podpory .NET 10 do knihovny DacFx a rozhraní příkazového řádku SqlPackage SqlPackage dotnet tool je k dispozici pro .NET 8 i .NET 10. |
Platforma; SqlPackage CLI; Rozhraní DACFx API / Porovnání schémat |
| Platform |
Přidání podpory .NET Standard 2.0 do knihovny DacFx |
Platforma; DacFx API / Porovnání schémat |
| Platform |
Odkazuje na Microsoft.Data.SqlClient verze 6.1.3. |
Platform |
| ScriptDom |
Aktualizace ScriptDom na verzi 170.157.0. |
Platform |
| Vector |
Rozšiřuje podporu vektorového sloupce tak, aby umožňovala změnu základního typu. |
SqlPackage CLI; MSBuild / SQL projekty; DacFx API / Porovnání schématu |
Fixes
| Feature |
Details |
Vztahuje se na |
| Deployment |
Opravili jsme chybu při nasazování do databáze SQL v Microsoft Fabric, když cílová databáze obsahovala zásady zabezpečení. |
SqlPackage CLI; DACFx API / Porovnání schématu |
| Export |
Opravili jsme problém, kdy exportované soubory selhaly .dacpac ověření schématu XSD kvůli logickým hodnotám atributů, které místo malých písmenTrue/False používaly true/false hodnoty.
Problém s GitHubem |
SqlPackage CLI |
| Import |
Opravili jsme problém, kdy import tabulky se speciálními znaky v názvu (například /, ", nebo $) proběhne neúspěšně bez jakéhokoli varování pro uživatele.
Problém s GitHubem |
SqlPackage CLI |
| Ledger |
Byl opraven problém, kdy účetní tabulka s počítaným sloupcem způsobovala chybu NullReferenceException během ověřování a sestavení modelu.
Problém s GitHubem |
PROJEKTY MSBuild / SQL; Rozhraní DACFx API / Porovnání schématu |
| Projekty SQL |
Opravili jsme problém, kdy sestavení projektu SQL se vloženou definicí seskupeného indexu columnstore na tabulce selhalo kvůli chybě syntaxe.
Problém s GitHubem |
Projekty MSBuild / SQL |
| Projekty SQL |
Opravili jsme problém, kdy bylo u clusterovaného indexu columnstore v tabulce s NVARCHAR(MAX) nebo jinými sloupci typu LOB nesprávně hlášeno, že indexy columnstore nejsou podporovány pro vektorové sloupce.
Problém s GitHubem |
Projekty MSBuild / SQL |
| Vector |
Opravili jsme problém, kdy postupy využívající VECTOR_SEARCH hlásily upozornění na ověření, že odkaz na sloupec nebylo možné vyřešit.
Problém s GitHubem |
PROJEKTY MSBuild / SQL; Rozhraní API DacFx / Porovnání schémat |
170.2.70 SqlPackage
Datum vydání: 14. října 2025
dotnet tool install -g microsoft.sqlpackage --version 170.2.70
Features
| Feature |
Details |
Vztahuje se na |
| Externí modely |
Přidali jsme podporu externích modelů ve službě Azure SQL Database a SQL Serveru 2025 (17.x) pro import, export, extrakci, nasazení a sestavení projektu SQL. |
SqlPackage CLI; MSBuild / SQL projekty; DACFx API / Porovnání schématu |
| Externí modely |
Přidání podpory pro funkce AI_GENERATE_CHUNKS a AI_GENERATE_EMBEDDINGS. |
SqlPackage CLI; DACFx API rozhraní / Porovnání schématu |
| JSON |
Přidání podpory indexů JSON ve službě Azure SQL Database a SQL Serveru 2025 (17.x) pro import, export, extrakci, nasazení a sestavení projektu SQL |
SqlPackage CLI; MSBuild / SQL projekty; DacFx API / Porovnání schématu |
| JSON |
Přidání podpory pro funkce JSON_ARRAYAGGJSON , JSON_OBJECTAGGa JSON_QUERY. |
SqlPackage CLI; PROJEKTY MSBuild / SQL; Rozhraní DACFx API / Porovnání schématu |
| Platform |
SqlPackage .zip .NET SDK sestavení byla aktualizována na verzi 8.0.414. |
Platforma; SqlPackage CLI |
| Regex (Regulární výraz) |
Byla přidána podpora funkce REGEXP_LIKE. |
SqlPackage CLI; PROJEKTY MSBuild / SQL; Rozhraní DACFx API / Porovnání schématu |
| ScriptDom |
Aktualizace ScriptDom na verzi 170.128.0 |
Platform |
| Vector |
Přidání podpory vektorových indexů ve službě Azure SQL Database a SQL Serveru 2025 (17.x) pro import, export, extrakci, nasazení a sestavení projektu SQL |
SqlPackage CLI; MSBuild / SQL projekty; DACFx API / porovnání schématu |
| Vector |
Rozšiřuje podporu vektorového datového typu na SQL Server 2025 (17.x) a určuje 32bitovou velikost float. |
SqlPackage CLI; MSBuild / SQL Projekty; DACFx API / Porovnání schématu |
| Vector |
Byla přidána podpora funkce VECTOR_SEARCHVector . |
SqlPackage CLI; MSBuild / SQL projekty; DacFx API / Porovnání schématu |
Fixes
| Feature |
Details |
Vztahuje se na |
| Maskování dat |
Opravili jsme problém, kdy se funkce maskování dat datetime během sestavování projektu nerozpoznaly.
Problém s GitHubem |
Projekty MSBuild / SQL |
| Externí modely |
Opravili jsme problém, kdy závislosti externího modelu na přihlašovacích údajích v oboru databáze způsobily selhání sestavení projektu. |
Projekty MSBuild / SQL |
| JSON |
Opravili jsme chybu při porovnávání indexů JSON s výchozí cestou JSON. |
DacFx API / Porovnání schématu; SqlPackage CLI |
| Platform |
Odkazuje na Microsoft.Data.SqlClient v5.1.7. |
Platform |
| jazyk XML |
Opravili jsme problém, kdy cesta dotazu XML (xQuery) nebyla během porovnání modelu brána v potaz rozlišování velkých a malých písmen. I u databází bez rozlišování malých a velkých písmen se v cestě xQuery rozlišují malá a velká písmena.
Problém s GitHubem |
DacFx API / Srovnání schémat; SqlPackage CLI |
170.1.61 SqlPackage
Datum vydání: 30. července 2025
dotnet tool install -g microsoft.sqlpackage --version 170.1.61
Features
| Feature |
Details |
Vztahuje se na |
| Virtualizace dat |
Přidání podpory pro objekty související s virtualizací dat pro Azure SQL Database při operacích importu, exportu, extrakce a publikování |
SqlPackage CLI |
| Virtualizace dat |
Přidání služby Azure SQL Database do publikování pomocí souborů parquet ve verzi Preview, což umožňuje importovat data do databáze pomocí služby Azure Blob Storage a souborů parquet. Extrahování dat do souborů Parquet není pro Azure SQL Database dostupné, protože závisí na funkcích, které CREATE EXTERNAL TABLE AS SELECT. |
SqlPackage CLI |
| Deployment |
Přidání podpory vlastností publikování /p:IgnorePreDeployScript a /p:IgnorePostDeployScript. Tyto vlastnosti mají výchozí hodnotu false a pokud jsou povoleny, výsledkem je vynechání odpovídajících skriptů v plánu nasazení.
Problém s GitHubem |
SqlPackage CLI; Rozhraní DacFx API / Porovnání schémat |
| Permissions |
Přidání podpory pro oprávnění ALTER ANY EXTERNAL MIRROR pro Azure SQL Database a databázi SQL v Microsoft Fabric. Toto oprávnění se vyžaduje k exportu databáze, která obsahuje jednu nebo více zrcadlených tabulek.
Problém s GitHubem |
SqlPackage CLI; Rozhraní DACFx API / Porovnání schématu |
| Permissions |
Přidání podpory pro oprávnění CREATE ANY EXTERNAL MODEL a ALTER ANY EXTERNAL MODEL pro SQL Server 2025 (17.x). |
SqlPackage CLI; Rozhraní DacFx API / Schématické porovnání |
| Permissions |
Přidání podpory oprávnění ALTER ANY INFORMATION PROTECTION pro SQL Server 2025 (17.x) a Azure SQL Database |
SqlPackage CLI; Rozhraní DACFx API / Porovnání schématu |
| Platform |
SqlPackage .zip build .NET SDK je aktualizována na verzi 8.0.412. |
Platforma; SqlPackage CLI |
| ScriptDom |
Aktualizace ScriptDom na verzi 170.0.64. |
Platform |
| ScriptDom |
Aktualizuje datový sklad platformy Fabric pro použití TSqlFabricDWParser v ScriptDom. |
Platforma; DacFx API / Porovnání schématu |
Fixes
| Feature |
Details |
Vztahuje se na |
| Trvale šifrováno |
Opravili jsme problém, kdy Interactive možnost parametru /AzureKeyVaultAuthMethod publikování nefungovala správně. |
SqlPackage CLI |
| Deployment |
Opravili jsme problém, kdy DbScopedConfigMaxDOPSecondaryvlastnost nebyla v nasazení nastavena správně.
Problém s GitHubem |
SqlPackage CLI; API DACFx / Porovnání schémat |
| Deployment |
Opravili jsme problém, kdy publikování tabulek obsahujících omezení cizího klíče selhalo se syntaxí, která není v datovém skladu v Microsoft Fabric podporovaná. |
SqlPackage CLI |
| Deployment |
Opravili jsme problém, kdy se při nasazování do databáze SQL v Microsoft Fabric zahrnuly objekty serveru. Objekty serveru nejsou v databázi SQL v Microsoft Fabric podporované.
Problém s GitHubem |
SqlPackage CLI |
| Deployment |
Opravili jsme problém, kdy se clusterované indexy columnstore vytvářejí nejprve vytvořením clusterovaného indexu, což zvyšuje režii a dobu nasazení.
Problém s GitHubem |
SqlPackage CLI |
| Extract |
Opravili jsme problém, kdy extrahování databáze z databáze SQL v Microsoft Fabric způsobuje nepoužitelné skripty definice uživatele.
Problém s GitHubem |
SqlPackage CLI |
170.0.94 SqlPackage
Datum vydání: 15. dubna 2025
dotnet tool install -g microsoft.sqlpackage --version 170.0.94
Features
| Feature |
Details |
Vztahuje se na |
| DACPACVerify |
Podpora pro ověření obsahu dvou .dacpac souborů byla přidána v nástroji pro náhled Microsoft.DacpacVerify. |
Rozhraní DACFx API / Porovnání schématu |
| Extract |
Přidání podpory pro rozbalení .dacpac souboru do složky Příkaz /Action:Extract se používá s /SourceFile: parametry a /TargetFile: parametry. Cílový soubor musí být složka a pokud je zadaný zdrojový soubor (.dacpac) nejsou platné žádné vlastnosti připojení k databázi. Vlastnost /p:ExtractTarget=SchemaObjectType je vyžadována pro extrakci ze .dacpac souboru místo zdrojové databáze. Spustitelný soubor Dacunpack.exe byl odstraněn z programu instalátoru DacFx.msi. |
SqlPackage CLI; DACFx API / Srovnání schémat |
| Parquet |
Přidána podpora pro datové typy timestamp, rowversion, uniqueidentifier, text, ntext, image, json, xml a vector při použití souborů Parquet ve službě Azure Blob Storage v operacích extrakce a publikování pomocí SqlPackage. |
SqlPackage CLI |
| Parquet |
Přidána podpora pro export a import dat tabulky do souborů BCP, pokud tabulka obsahuje nepodporovaný datový typ, a zároveň použití souborů Parquet ve službě Azure Blob Storage pro zpracování zbývajících dat během operací extrakce a publikování pomocí SqlPackage. Příklad datového typu je sql_variant a tabulka obsahující sloupec tohoto typu se zapíše do BCP v .dacpac době, kdy se zbývající tabulky zapisují do souborů Parquet v Azure Blob Storage. |
SqlPackage CLI |
| Platform |
Aktualizace SqlPackage pro verzi rozhraní .NET Framework na .NET Framework 4.7.2 |
Platforma; SqlPackage CLI |
| Platform |
Byla odebrána podpora pro .NET 6. |
Platforma; SqlPackage CLI |
| ScriptDom |
Aktualizace ScriptDom na verzi 170.18.0. |
Platform |
| Projekty SQL |
Výchozí úroveň kompatibility pro Azure SQL Database a databázi SQL v Microsoft Fabric je teď nastavená na 170. Další informace najdete v tématu Úroveň kompatibility databáze 170 ve službě Azure SQL Database a databáze SQL v Microsoft Fabric. |
Projekty MSBuild / SQL |
| Vector |
Datový typ vektoru je nyní podporován v cílové platformě Azure SQL Database pro sestavení importu, exportu, extrakce, nasazení a projektu SQL. |
SqlPackage CLI; MSBuild / SQL projekty; DacFx API / Porovnání schématu |
Fixes
| Feature |
Details |
Vztahuje se na |
| Deployment |
Opravili jsme problém, kdy nasazení změny do externí tabulky způsobovala, že se všechny externí tabulky zahodí a znovu vytvoří, pokud upravená tabulka neobsáhne žádné hodnoty pro REJECT_VALUE nebo REJECT_SAMPLE_VALUE. |
SqlPackage CLI; DACFx API / Porovnání schémat |
| Deployment |
Opravili jsme problém, kdy změna sloupce pro rozšíření jeho délky způsobovala nesprávné varování o ztrátě dat, pokud byla zadána kolace sloupce a odpovídala výchozí kolaci databáze.
Problém s GitHubem |
SqlPackage CLI; DacFx API / Porovnání schémat |
| Deployment |
Opravili jsme problém, kdy změny klasifikace citlivosti v tabulce způsobovaly opětovné vytvoření indexů.
Problém s GitHubem |
SqlPackage CLI; DacFx API / Porovnání schématu |
| Export |
Optimalizovali jsme využití odhadu velikosti tabulky během operací exportu. |
SqlPackage CLI |
| Extract |
Opravili jsme problém, kdy selhává extrakce .dacpac z důvodu odkazu na databázi.
Problém s GitHubem |
SqlPackage CLI; Rozhraní DACFx API / Porovnání schématu |
| Datový sklad Fabrique |
Opravili jsme problém, kdy se během operace publikování volá systémová uložená procedura sp_refreshsqlmodule. Datový sklad Fabric nepodporuje sp_refreshsqlmodule, což způsobuje selhání nasazení. |
SqlPackage CLI |
| Datový sklad Fabrique |
Opravili jsme problém, kdy byla omezení tabulek zahrnuta do souborů .dacpac, ale ne do souborů .sql, když byla databáze extrahována z Fabric Data Warehouse.
Problém s GitHubem |
SqlPackage CLI |
| Projekty SQL |
Byl opraven problém, kdy sestavení bez nainstalovaného SSDT v sadě Visual Studio způsobovalo nesprávné chování sestavení.
Problém s GitHubem |
Projekty MSBuild / SQL |
| Projekty SQL |
Opravili jsme problém, kdy se ve výstupu duplikovaly upozornění sestavení, když je povolená analýza kódu.
Problém s GitHubem |
Projekty MSBuild / SQL |
| Projekty SQL |
Opravili jsme problém, kdy parametry zprostředkovatele služeb nastavené na proměnné způsobily falešná upozornění.
Problém s GitHubem |
Projekty MSBuild / SQL |
Archivované verze (162.x a starší verze)
Poznámky k verzi 162.x a starším verzím najdete v poznámkách k vydání pro SqlPackage (archiv).