de nieuwste versie downloaden
In dit artikel vindt u een overzicht van de functies en oplossingen die worden geleverd door de uitgebrachte versies van SqlPackage.
Hoe u deze release-opmerkingen kunt lezen
De kolom Van toepassing op in elke sectie is als volgt gedefinieerd:
-
SqlPackage CLI - opdrachtregelacties (publiceren, importeren, exporteren, extraheren, Parquet, diagnostische gegevens, dotnet-hulpprogramma)
-
MSBuild / SQL-projecten - SQL-projectbuild (
Microsoft.Build.Sql SDK, SQL Server Data Tools (SSDT)-integratie)
-
DacFx-API/Schema vergelijken -
Microsoft.SqlServer.DacFx NuGet-API's, schema vergelijken
-
Platform - ScriptDom, Microsoft.Data.SqlClient, .NET-ondersteuning, systeem DACPACs, compatibiliteitsstandaarden
Huidige releases (170.x)
De volgende releases zijn de momenteel ondersteunde versies van SqlPackage.
170.3.93 SqlPackage
Releasedatum: 10 februari 2026
dotnet tool install -g microsoft.sqlpackage --version 170.3.93
Features
| Feature |
Details |
Van toepassing op: |
| Deployment |
Ondersteuning toegevoegd voor databaseopties ACCELERATED_DATABASE_RECOVERY en OPTIMIZED_LOCKING. |
SqlPackage CLI; DacFx-API/Schema vergelijken |
| Permissions |
Verbetert de publicatie van machtigingen door EXECUTE ON EXTERNAL MODEL rechten op te nemen. |
SqlPackage CLI; DacFx-API/Schema vergelijken |
| Platform |
.NET 10-ondersteuning toegevoegd aan de DacFx-bibliotheek en de SqlPackage CLI. SqlPackage dotnet tool is beschikbaar voor zowel .NET 8 als .NET 10. |
Platform; SqlPackage CLI; DacFx-API/Schema vergelijken |
| Platform |
.NET Standard 2.0-ondersteuning toegevoegd aan de DacFx-bibliotheek. |
Platform; DacFx-API/Schema vergelijken |
| Platform |
Verwijst naar Microsoft.Data.SqlClient v6.1.3. |
Platform |
| ScriptDom |
ScriptDom bijgewerkt naar versie 170.157.0. |
Platform |
| Vector |
Breidt vectorkolomondersteuning uit om het basistype te wijzigen. |
SqlPackage CLI; MSBuild/ SQL-projecten; DacFx-API/Schema vergelijken |
Fixes
| Feature |
Details |
Van toepassing op: |
| Deployment |
Er is een fout opgelost bij het implementeren naar SQL-database in Microsoft Fabric wanneer de doeldatabase een beveiligingsbeleid bevat. |
SqlPackage CLI; DacFx-API/Schema vergelijken |
| Export |
Er is een probleem opgelost waarbij geëxporteerde .dacpac-bestanden falen voor XSD-schemavalidatie vanwege booleaanse kenmerkwaarden die True/False-waarden gebruiken in plaats van kleine letters true/false.
GitHub-probleem |
SqlPackage CLI |
| Import |
Er is een probleem opgelost waarbij het importeren van een tabel met speciale tekens in de naam (zoals /, "of $) op de achtergrond geen gegevens kan importeren zonder de gebruiker te waarschuwen.
GitHub-probleem |
SqlPackage CLI |
| Ledger |
Er is een probleem opgelost waarbij een grootboektabel met een berekende kolom een NullReferenceException probleem veroorzaakt tijdens modelvalidatie en -build.
GitHub-probleem |
MSBuild/ SQL-projecten; DacFx-API/Schema vergelijken |
| SQL-projecten |
Er is een probleem opgelost waarbij het bouwen van een SQL-project met een inline geclusterde columnstore-indexdefinitie in een tabel mislukt met een syntaxisfout.
GitHub-probleem |
MSBuild/ SQL-projecten |
| SQL-projecten |
Er is een probleem opgelost waarbij een geclusterde columnstore-index in een tabel met NVARCHAR(MAX) of andere LOB-type kolommen een fout rapporteert dat columnstore-indexen niet worden ondersteund met vectorkolommen.
GitHub-probleem |
MSBuild/ SQL-projecten |
| Vector |
Er is een probleem opgelost waarbij procedures met behulp van VECTOR_SEARCH een validatiewaarschuwing rapporteren dat de kolomreferentie niet kon worden opgelost.
GitHub-probleem |
MSBuild/ SQL-projecten; DacFx-API/Schema vergelijken |
170.2.70 SqlPackage
Releasedatum: 14 oktober 2025
dotnet tool install -g microsoft.sqlpackage --version 170.2.70
Features
| Feature |
Details |
Van toepassing op: |
| Externe modellen |
Er is ondersteuning toegevoegd voor externe modellen in Azure SQL Database en SQL Server 2025 (17.x) voor het importeren, exporteren, extraheren, implementeren en bouwen van SQL-projecten. |
SqlPackage CLI; MSBuild/ SQL-projecten; DacFx-API/Schema vergelijken |
| Externe modellen |
Er is ondersteuning toegevoegd voor functies AI_GENERATE_CHUNKS en AI_GENERATE_EMBEDDINGS. |
SqlPackage CLI; DacFx-API/Schema vergelijken |
| JSON |
Er is ondersteuning toegevoegd voor JSON-indexen in Azure SQL Database en SQL Server 2025 (17.x) voor het importeren, exporteren, extraheren, implementeren en bouwen van SQL-projecten. |
SqlPackage CLI; MSBuild/ SQL-projecten; DacFx-API/Schema vergelijken |
| JSON |
Er is ondersteuning toegevoegd voor JSON-functies JSON_ARRAYAGG, JSON_OBJECTAGGen JSON_QUERY. |
SqlPackage CLI; MSBuild/ SQL-projecten; DacFx-API/Schema vergelijken |
| Platform |
De SqlPackage-build .zip .NET SDK wordt bijgewerkt naar 8.0.414 |
Platform; SqlPackage CLI |
| Regex |
Er is ondersteuning toegevoegd voor de REGEXP_LIKE functie. |
SqlPackage CLI; MSBuild/ SQL-projecten; DacFx-API/Schema vergelijken |
| ScriptDom |
ScriptDom bijgewerkt naar versie 170.128.0. |
Platform |
| Vector |
Er is ondersteuning toegevoegd voor de vectorindexen in Azure SQL Database en SQL Server 2025 (17.x) voor het importeren, exporteren, extraheren, implementeren en bouwen van SQL-projecten. |
SqlPackage CLI; MSBuild/ SQL-projecten; DacFx-API/Schema vergelijken |
| Vector |
Breidt de ondersteuning voor vectorgegevenstype uit naar SQL Server 2025 (17.x) en geeft de 32-bits floatgrootte op. |
SqlPackage CLI; MSBuild/ SQL-projecten; DacFx-API/Schema vergelijken |
| Vector |
Er is ondersteuning toegevoegd voor vectorfunctie VECTOR_SEARCH. |
SqlPackage CLI; MSBuild/ SQL-projecten; DacFx-API/Schema vergelijken |
Fixes
| Feature |
Details |
Van toepassing op: |
| Gegevensmaskering |
Er is een probleem opgelost waarbij de functies voor datum/tijd-gegevensmaskering niet werden herkend tijdens de projectbuild.
GitHub-probleem |
MSBuild/ SQL-projecten |
| Externe modellen |
Er is een probleem opgelost waarbij afhankelijkheden van een extern model op basis van een databasereferentie ertoe leiden dat de projectbuild mislukt. |
MSBuild/ SQL-projecten |
| JSON |
Er is een fout opgelost bij het vergelijken van JSON-indexen met het standaard JSON-pad. |
DacFx-API/schema vergelijken; SqlPackage CLI |
| Platform |
Verwijst naar Microsoft.Data.SqlClient v5.1.7. |
Platform |
| XML |
Er is een probleem opgelost waarbij het XML-querypad (xQuery) tijdens modelvergelijking niet als hoofdlettergevoelig werd behandeld. Zelfs bij niet-hoofdlettergevoelige databases is het xQuery-pad hoofdlettergevoelig.
GitHub-probleem |
DacFx-API/schema vergelijken; SqlPackage CLI |
170.1.61 SqlPackage
Releasedatum: 30 juli 2025
dotnet tool install -g microsoft.sqlpackage --version 170.1.61
Features
| Feature |
Details |
Van toepassing op: |
| Gegevensvirtualisatie |
Er is ondersteuning toegevoegd voor objecten met betrekking tot gegevensvirtualisatie voor Azure SQL Database bij import-, export-, extract- en publicatiebewerkingen. |
SqlPackage CLI |
| Gegevensvirtualisatie |
Azure SQL Database toegevoegd aan de publicatie met parquet-bestanden preview, waardoor het gebruik van Azure Blob Storage- en Parquet-bestanden wordt ingeschakeld om gegevens in een database te importeren. Het extraheren van gegevens naar Parquet-bestanden is niet beschikbaar voor Azure SQL Database, omdat deze afhankelijk is van de functionaliteit die niet beschikbaar is in Azure SQL Database, CREATE EXTERNAL TABLE AS SELECT. |
SqlPackage CLI |
| Deployment |
Er is ondersteuning toegevoegd voor publicatie-eigenschappen /p:IgnorePreDeployScript en /p:IgnorePostDeployScript. Deze eigenschappen zijn standaard ingesteld op false, en wanneer deze zijn ingeschakeld, resulteert dit in het weglaten van de bijbehorende scripts in het implementatieplan.
GitHub-probleem |
SqlPackage CLI; DacFx-API/Schema vergelijken |
| Permissions |
Er is ondersteuning toegevoegd voor de machtiging ALTER ANY EXTERNAL MIRROR voor Azure SQL Database en SQL Database in Microsoft Fabric. Deze machtiging is vereist voor het exporteren van een database die een of meer gespiegelde tabellen bevat.
GitHub-probleem |
SqlPackage CLI; DacFx-API/Schema vergelijken |
| Permissions |
Er is ondersteuning toegevoegd voor de machtigingen CREATE ANY EXTERNAL MODEL en ALTER ANY EXTERNAL MODEL voor SQL Server 2025 (17.x). |
SqlPackage CLI; DacFx-API/Schema vergelijken |
| Permissions |
Er is ondersteuning toegevoegd voor de machtiging ALTER ANY INFORMATION PROTECTION voor SQL Server 2025 (17.x) en Azure SQL Database. |
SqlPackage CLI; DacFx-API/Schema vergelijken |
| Platform |
De .NET SDK van de SqlPackage-build .zip wordt bijgewerkt naar 8.0.412. |
Platform; SqlPackage CLI |
| ScriptDom |
ScriptDom bijgewerkt naar versie 170.0.64. |
Platform |
| ScriptDom |
Hiermee werkt u het datawarehouse van de Fabric-platform bij zodat het TSqlFabricDWParser in ScriptDom kan gebruiken. |
Platform; DacFx-API/Schema vergelijken |
Fixes
| Feature |
Details |
Van toepassing op: |
| Altijd versleuteld |
Er is een probleem opgelost waarbij de Interactive optie voor de /AzureKeyVaultAuthMethod publicatieparameter niet correct werkte. |
SqlPackage CLI |
| Deployment |
Er is een probleem opgelost waarbij de DbScopedConfigMaxDOPSecondaryeigenschap niet juist was ingesteld in de implementatie.
GitHub-probleem |
SqlPackage CLI; DacFx-API/Schema vergelijken |
| Deployment |
Er is een probleem opgelost waarbij het publiceren van tabellen met vreemde sleutel beperkingen mislukt vanwege syntaxis die niet wordt ondersteund in data-warehouse in Microsoft Fabric. |
SqlPackage CLI |
| Deployment |
Er is een probleem opgelost waarbij serverobjecten werden opgenomen bij de implementatie in SQL Database in Microsoft Fabric. Serverobjecten worden niet ondersteund in SQL Database in Microsoft Fabric.
GitHub-probleem |
SqlPackage CLI |
| Deployment |
Er is een probleem opgelost waarbij geclusterde columnstore-indexen worden gemaakt door eerst een geclusterde index te maken, wat de overhead en tijd van de implementatie verhoogt.
GitHub-probleem |
SqlPackage CLI |
| Extract |
Er is een probleem opgelost waarbij het extraheren van een database uit een SQL-database in Microsoft Fabric resulteert in onbruikbare scripts voor gebruikersdefinities.
GitHub-probleem |
SqlPackage CLI |
170.0.94 SqlPackage
Releasedatum: 15 april 2025
dotnet tool install -g microsoft.sqlpackage --version 170.0.94
Features
| Feature |
Details |
Van toepassing op: |
| DACPACVerify |
Ondersteuning voor het verifiëren van de inhoud van twee .dacpac bestanden is toegevoegd in de preview-tool Microsoft.DacpacVerify. |
DacFx-API/Schema vergelijken |
| Extract |
Er is ondersteuning toegevoegd voor het uitpakken van een .dacpac bestand in een map. Het /Action:Extract commando wordt gebruikt met /SourceFile: en /TargetFile: parameters. Het doelbestand moet een map zijn en wanneer een bronbestand (.dacpac) is opgegeven, zijn er geen eigenschappen van de databaseverbinding geldig. De eigenschap /p:ExtractTarget=SchemaObjectType is vereist voor het extraheren uit een .dacpac bestand in plaats van uit een brondatabase. Het uitvoerbare bestand Dacunpack.exe wordt verwijderd uit het DacFx.msi installatieprogramma. |
SqlPackage CLI; DacFx-API/Schema vergelijken |
| Parquet |
Er is ondersteuning toegevoegd voor de tijdstempel, rowversion, uniqueidentifier, tekst, ntext, afbeelding, json, xml en vector bij het gebruik van Parquet-bestanden in Azure Blob Storage met sqlPackage-extract- en publicatiebewerkingen. |
SqlPackage CLI |
| Parquet |
Er is ondersteuning toegevoegd voor het exporteren en importeren van tabelgegevens naar BCP-bestanden wanneer de tabel een niet-ondersteund gegevenstype bevat tijdens het gebruik van Parquet-bestanden in Azure Blob Storage voor de resterende gegevens met SqlPackage-extract- en publicatiebewerkingen. Een voorbeeld van een gegevenstype is sql_variant en een tabel met een kolom van dat type wordt geschreven naar BCP terwijl .dacpac de resterende tabellen naar Parquet-bestanden in Azure Blob Storage worden geschreven. |
SqlPackage CLI |
| Platform |
SqlPackage voor .NET Framework-versie bijgewerkt naar .NET Framework 4.7.2. |
Platform; SqlPackage CLI |
| Platform |
Ondersteuning voor .NET 6 verwijderd. |
Platform; SqlPackage CLI |
| ScriptDom |
ScriptDom bijgewerkt naar versie 170.18.0. |
Platform |
| SQL-projecten |
Het standaardcompatibiliteitsniveau voor Azure SQL Database en SQL Database in Microsoft Fabric is nu ingesteld op 170. Zie Databasecompatibiliteitsniveau 170 in Azure SQL Database en SQL-database in Microsoft Fabric voor meer informatie. |
MSBuild/ SQL-projecten |
| Vector |
Het vectorgegevenstype wordt nu ondersteund in het doelplatform Azure SQL Database voor importeren, exporteren, extraheren, implementeren en bouwen van SQL-projecten. |
SqlPackage CLI; MSBuild/ SQL-projecten; DacFx-API/Schema vergelijken |
Fixes
| Feature |
Details |
Van toepassing op: |
| Deployment |
Er is een probleem opgelost waarbij het implementeren van een wijziging in een externe tabel ervoor zorgt dat alle externe tabellen worden verwijderd en opnieuw worden gemaakt als de gewijzigde tabel geen waarden voor REJECT_VALUE of REJECT_SAMPLE_VALUEbevat. |
SqlPackage CLI; DacFx-API/Schema vergelijken |
| Deployment |
Er is een probleem opgelost waarbij het wijzigen van een kolom om de lengte ervan uit te breiden resulteert in een onjuiste waarschuwing voor gegevensverlies als de sortering van de kolom is opgegeven en overeenkomt met de standaardsortering van de database.
GitHub-probleem |
SqlPackage CLI; DacFx-API/Schema vergelijken |
| Deployment |
Er is een probleem opgelost waarbij wijzigingen in vertrouwelijkheidsclassificatie in een tabel ertoe leiden dat indexen opnieuw worden gemaakt.
GitHub-probleem |
SqlPackage CLI; DacFx-API/Schema vergelijken |
| Export |
Het gebruik van tabelgrootteschatting tijdens exportbewerkingen is geoptimaliseerd. |
SqlPackage CLI |
| Extract |
Er is een probleem opgelost waarbij het extraheren van een .dacpac samen met een databaseverwijzing mislukt.
GitHub-probleem |
SqlPackage CLI; DacFx-API/Schema vergelijken |
| Fabric Data Warehouse |
Er is een probleem opgelost waarbij de door het sp_refreshsqlmodule systeem opgeslagen procedure wordt aangeroepen tijdens een publicatiebewerking. Fabric Data Warehouse biedt geen ondersteuning sp_refreshsqlmodule en dit zorgt ervoor dat de implementatie mislukt. |
SqlPackage CLI |
| Fabric Data Warehouse |
Er is een probleem opgelost waarbij tabelbeperkingen worden opgenomen in een .dacpac maar geen .sql bestanden wanneer een database werd geëxtraheerd uit een Fabric Data Warehouse.
GitHub-probleem |
SqlPackage CLI |
| SQL-projecten |
Er is een probleem opgelost waarbij bouwen zonder SSDT in Visual Studio resulteert in onjuist buildgedrag.
GitHub-probleem |
MSBuild/ SQL-projecten |
| SQL-projecten |
Er is een probleem opgelost waarbij buildwaarschuwingen in uitvoer worden gedupliceerd wanneer codeanalyse is ingeschakeld.
GitHub-probleem |
MSBuild/ SQL-projecten |
| SQL-projecten |
Er is een probleem opgelost waarbij servicebrokerparameters die zijn ingesteld op variabelen, leiden tot valse waarschuwingen.
GitHub-probleem |
MSBuild/ SQL-projecten |
Gearchiveerde releases (162.x en eerdere versies)
U vindt releaseopmerkingen voor versie 162.x en oudere versies in de releaseopmerkingen voor SqlPackage (archief).