Notes de publication de SqlPackage

Télécharger la version la plus récente

Cet article présente les fonctionnalités et les correctifs fournis par les versions commerciales de SqlPackage.

Comment lire ces notes de publication

La colonne S’applique à dans chaque section est définie comme suit :

• Interface CLI SqlPackage - Actions de ligne de commande (publier, importer, exporter, extraire, Parquet, diagnostics, outil dotnet)
• Projets MSBuild / SQL - Compilation de projet SQL (Microsoft.Build.Sql SDK, intégration des SQL Server Data Tools (SSDT))
• API DacFx / Comparaison de schémas - Microsoft.SqlServer.DacFx API NuGet, comparaison de schémas
• Plateforme - ScriptDom, Microsoft.Data.SqlClient, prise en charge de .NET, DACPACs système, valeurs par défaut de compatibilité

Versions actuelles (170.x)

Les versions suivantes sont les versions actuellement prises en charge de SqlPackage.

170.3.93 SqlPackage

Date de publication : 10 février 2026

dotnet tool install -g microsoft.sqlpackage --version 170.3.93

Platform	Download
Windows .NET 10	fichier .zip
Windows	fichier .msi
macOS .NET 10	fichier .zip
Linux .NET 10	fichier .zip

Features

Feature	Details	S’applique à
Deployment	Ajout de la prise en charge des options de base de données ACCELERATED_DATABASE_RECOVERY et OPTIMIZED_LOCKING.	CLI SqlPackage ; API DacFx / Comparaison de schéma
Permissions	Améliore la publication des autorisations pour inclure EXECUTE ON EXTERNAL MODEL.	CLI SqlPackage ; API DacFx / Comparaison de schémas
Platform	Ajout de la prise en charge de .NET 10 à la bibliothèque DacFx et à l’interface CLI SqlPackage. SqlPackage dotnet tool est disponible pour .NET 8 et .NET 10.	Plate-forme; Interface CLI SqlPackage ; API DacFx / Comparaison de schémas
Platform	Ajout de la prise en charge de .NET Standard 2.0 à la bibliothèque DacFx.	Plate-forme; API DacFx / Comparaison de schémas
Platform	Fait référence à Microsoft.Data.SqlClient v6.1.3.	Platform
ScriptDom	Mise à jour de ScriptDom vers la version 170.157.0.	Platform
Vector	Étend la prise en charge des colonnes vectorielles pour permettre la modification du type de base.	CLI SqlPackage, Projets MSBuild / SQL, API DacFx / Comparaison de schémas

Fixes

Feature	Details	S’applique à
Deployment	Correction d’un bogue avec le déploiement sur une base de données SQL dans Microsoft Fabric lorsque la base de données cible inclut une stratégie de sécurité.	Interface CLI SqlPackage ; API DacFx / Comparaison de schémas
Export	Correction d’un problème où les fichiers exportés .dacpac échouent à la validation du schéma XSD en raison de valeurs d’attribut booléennes utilisant True/False au lieu des valeurs en minuscules true/false. Problème GitHub	SqlPackage CLI
Import	Correction d’un problème où l’importation d’une table avec des caractères spéciaux dans le nom (comme /, " ou $) échoue à importer les données sans avertir l’utilisateur. Problème GitHub	SqlPackage CLI
Ledger	Correction d’un problème où une table de registre avec une colonne calculée provoque une NullReferenceException validation de modèle et une génération. Problème GitHub	Projets MSBuild / SQL ; API DacFx / Comparaison de schémas
Projets SQL	Correction d’un problème où la création d’un projet SQL avec une définition d’index columnstore en cluster inline sur une table échoue avec une erreur de syntaxe. Problème GitHub	Projets MSBuild / SQL
Projets SQL	Correction d’un problème où un index columnstore en cluster sur une table avec NVARCHAR(MAX) ou d’autres colonnes de type LOB signale incorrectement une erreur indiquant que les index columnstore ne sont pas pris en charge avec les colonnes vectorielles. Problème GitHub	Projets MSBuild / SQL
Vector	Correction d’un problème où les procédures utilisant VECTOR_SEARCH signalent un avertissement de validation indiquant que la référence de colonne ne peut être résolue. Problème GitHub	Projets MSBuild / SQL ; API DacFx / Comparaison de schémas

170.2.70 SqlPackage

Date de publication : 14 octobre 2025

dotnet tool install -g microsoft.sqlpackage --version 170.2.70

Platform	Download
Windows .NET 8	fichier .zip
Windows	fichier .msi
macOS .NET 8	fichier .zip
Linux .NET 8	fichier .zip

Features

Feature	Details	S’applique à
Modèles externes	Ajout de la prise en charge des modèles externes dans Azure SQL Database et SQL Server 2025 (17.x) pour l’importation, l’exportation, l’extraction, le déploiement et la génération de projet SQL.	Interface CLI SqlPackage ; Projets MSBuild / SQL ; API DacFx / Comparaison de schéma
Modèles externes	Ajout de la prise en charge des fonctions AI_GENERATE_CHUNKS et AI_GENERATE_EMBEDDINGS.	Interface en ligne de commande SqlPackage ; API DacFx / Comparaison de schémas
JSON	Ajout de la prise en charge des index JSON dans Azure SQL Database et SQL Server 2025 (17.x) pour l’importation, l’exportation, l’extraction, le déploiement et la génération de projet SQL.	Interface CLI SqlPackage ; Projets MSBuild / SQL ; API DacFx / Comparaison de schéma
JSON	Ajout de la prise en charge des fonctions JSON_ARRAYAGGJSON, JSON_OBJECTAGGet JSON_QUERY.	interface CLI SqlPackage ; projets MSBuild / SQL ; API DacFx / Comparaison des schémas
Platform	Le Kit de développement logiciel (SDK) .NET de build SqlPackage .zip est mis à jour vers la version 8.0.414	Plate-forme; SqlPackage CLI
Regex	Ajout de la prise en charge de la fonction REGEXP_LIKE.	SQLPackage CLI ; Projets MSBuild / SQL ; API DacFx / Comparaison de schémas
ScriptDom	Mise à jour de ScriptDom vers la version 170.128.0.	Platform
Vector	Ajout de la prise en charge des index vectoriels dans Azure SQL Database et SQL Server 2025 (17.x) pour l’importation, l’exportation, l’extraction, le déploiement et la génération de projet SQL.	Interface CLI SqlPackage ; Projets MSBuild / SQL ; API DacFx / Comparaison de schéma
Vector	Développe la prise en charge du type de données vectorielles vers SQL Server 2025 (17.x) et spécifie la taille flottante 32 bits.	Interface CLI SqlPackage ; Projets MSBuild / SQL ; API DacFx / Comparaison de schémas
Vector	Ajout de la prise en charge de la fonction VECTOR_SEARCHVector .	Interface CLI SqlPackage ; Projets MSBuild / SQL ; API DacFx / Comparaison de schéma

Fixes

Feature	Details	S’applique à
Masquage des données	Correction d’un problème où les fonctions de masquage des données datetime n’étaient pas reconnues lors de la génération du projet. Problème GitHub	Projets MSBuild / SQL
Modèles externes	Correction d’un problème où les dépendances externes de modèle sur des informations d’identification liées à la base de données provoquent l’échec de la construction du projet.	Projets MSBuild / SQL
JSON	Correction d’un bogue lors de la comparaison des index JSON avec le chemin JSON par défaut.	API DacFx / Comparaison de schémas ; SqlPackage CLI
Platform	Fait référence à Microsoft.Data.SqlClient v5.1.7.	Platform
XML	Correction d’un problème où le chemin de requête XML (xQuery) n’était pas traité comme sensible à la casse lors de la comparaison de modèles. Même sur les bases de données insensibles à la casse, le chemin d'accès xQuery est sensible à la casse. Problème GitHub	API DacFx / Comparaison de schémas ; SqlPackage CLI

170.1.61 SqlPackage

Date de publication : 30 juillet 2025

dotnet tool install -g microsoft.sqlpackage --version 170.1.61

Platform	Download
Windows .NET 8	fichier .zip
Windows	fichier .msi
macOS .NET 8	fichier .zip
Linux .NET 8	fichier .zip

Features

Feature	Details	S’applique à
Virtualisation de données	Ajout de la prise en charge des objets liés à la virtualisation des données pour Azure SQL Database dans les opérations d’importation, d’exportation, d’extraction et de publication.	SqlPackage CLI
Virtualisation de données	Ajout d’Azure SQL Database à la publication avec des fichiers Parquet en préversion, ce qui permet d’utiliser le Stockage Blob Azure et les fichiers Parquet pour importer des données dans une base de données. L’extraction de données dans des fichiers Parquet n’est pas disponible pour Azure SQL Database, car elle dépend des fonctionnalités non disponibles dans Azure SQL Database. CREATE EXTERNAL TABLE AS SELECT	SqlPackage CLI
Deployment	Ajout de la prise en charge des propriétés de publication /p:IgnorePreDeployScript et /p:IgnorePostDeployScript. Ces propriétés ont la valeur par défaut false et, quand elles sont activées, le plan de déploiement omettant les scripts correspondants. Problème GitHub	Interface CLI SqlPackage ; API DacFx / Comparaison de schémas
Permissions	Ajout de la prise en charge de l’autorisation ALTER ANY EXTERNAL MIRROR pour Azure SQL Database et SQL Database dans Microsoft Fabric. Cette autorisation est nécessaire pour exporter une base de données qui contient une ou plusieurs tables mises en miroir. Problème GitHub	Interface CLI SqlPackage ; API DacFx / Comparaison de schémas
Permissions	Ajout de la prise en charge des autorisations CREATE ANY EXTERNAL MODEL et ALTER ANY EXTERNAL MODEL de SQL Server 2025 (17.x).	Interface CLI SqlPackage ; API DacFx / Comparaison de schémas
Permissions	Ajout du support de l’autorisation ALTER ANY INFORMATION PROTECTION pour SQL Server 2025 (17.x) et Azure SQL Database.	Interface CLI SqlPackage ; API DacFx / Comparaison de schémas
Platform	Le Kit de développement logiciel (SDK) .NET de build SqlPackage .zip est mis à jour vers la version 8.0.412.	Plate-forme; SqlPackage CLI
ScriptDom	Mise à jour de ScriptDom vers la version 170.0.64.	Platform
ScriptDom	Met à jour l’entrepôt de données dans la plateforme Fabric pour l’utiliser TSqlFabricDWParser dans ScriptDom.	Plate-forme; API DacFx / Comparaison de schémas

Fixes

Feature	Details	S’applique à
Toujours Chiffré	Correction d’un problème où l’option Interactive du /AzureKeyVaultAuthMethod paramètre de publication ne fonctionnait pas correctement.	SqlPackage CLI
Deployment	Correction d’un problème où la DbScopedConfigMaxDOPSecondarypropriété n’était pas définie correctement dans le déploiement. Problème GitHub	SqlPackage CLI ; DacFx API / Comparaison de schéma
Deployment	Correction d’un problème où la publication de tables contenant des contraintes de clé étrangère échoue à s'exécuter en raison d’une syntaxe non prise en charge dans le Data Warehouse de Microsoft Fabric.	SqlPackage CLI
Deployment	Correction d’un problème où les objets serveur étaient inclus lors du déploiement sur une base de données SQL dans Microsoft Fabric. Les objets serveur ne sont pas pris en charge dans la base de données SQL dans Microsoft Fabric. Problème GitHub	SqlPackage CLI
Deployment	Correction d’un problème où les index columnstore en cluster sont créés en créant d’abord un index cluster, ce qui augmente la surcharge de déploiement et le temps. Problème GitHub	SqlPackage CLI
Extract	Correction d’un problème où l’extraction d’une base de données à partir d’une base de données SQL dans Microsoft Fabric entraîne des scripts de définition utilisateur inutilisables. Problème GitHub	SqlPackage CLI

170.0.94 SqlPackage

Date de publication : 15 avril 2025

dotnet tool install -g microsoft.sqlpackage --version 170.0.94

Platform	Download
Windows .NET 8	fichier .zip
Windows	fichier .msi
macOS .NET 8	fichier .zip
Linux .NET 8	fichier .zip

Features

Feature	Details	S’applique à
DACPACVerify	La prise en charge de la vérification du contenu de deux .dacpac fichiers est ajoutée dans l’outil de préversion Microsoft.DacpacVerify.	API DacFx / Comparaison de schémas
Extract	Ajout de la prise en charge de la décompression d’un fichier .dacpac dans un dossier. La commande /Action:Extract est utilisée avec les paramètres /SourceFile: et /TargetFile:. Le fichier cible doit être un dossier et quand un fichier source (.dacpac) n’est spécifié, aucune propriété de connexion de base de données n’est valide. La propriété /p:ExtractTarget=SchemaObjectType est requise pour l’extraction d’un .dacpac fichier au lieu d’une base de données source. L’exécutable Dacunpack.exe est supprimé du programme d’installation DacFx.msi .	Interface en ligne de commande SqlPackage ; API DacFx / Comparaison de schémas
Parquet	Ajout du support pour les types de données timestamp, rowversion, uniqueidentifier, text, ntext, image, json, xml et vector lors de l’utilisation de fichiers Parquet dans le stockage Blob Azure avec des opérations d'extraction et de publication SqlPackage.	SqlPackage CLI
Parquet	Ajout de la prise en charge de l'exportation et de l'importation de données de table dans des fichiers BCP lorsque la table contient un type de données non pris en charge, lors de l'utilisation de fichiers Parquet dans Azure Blob Storage pour le reste des données, avec les opérations d'extraction et de publication SqlPackage. Un exemple de type de données est sql_variant, et une table contenant une colonne de ce type est écrite dans BCP alors que les autres tables sont écrites dans des fichiers Parquet sur le stockage Blob Azure.	SqlPackage CLI
Platform	Mise à jour de SqlPackage pour .NET Framework vers .NET Framework 4.7.2.	Plate-forme; SqlPackage CLI
Platform	Suppression de la prise en charge pour .NET 6.	Plate-forme; SqlPackage CLI
ScriptDom	Mise à jour de ScriptDom vers la version 170.18.0.	Platform
Projets SQL	Le niveau de compatibilité par défaut pour Azure SQL Database et la base de données SQL dans Microsoft Fabric est désormais défini sur 170. Pour plus d’informations, consultez le niveau de compatibilité de base de données 170 dans Azure SQL Database et la base de données SQL dans Microsoft Fabric.	Projets MSBuild / SQL
Vector	Le type de données vectorielles est désormais pris en charge dans la plateforme Azure SQL Database cible pour l’importation, l’exportation, l’extraction, le déploiement et la génération du projet SQL.	interface CLI SqlPackage ; projets MSBuild / SQL ; API DacFx / Comparaison des schémas

Fixes

Feature	Details	S’applique à
Deployment	Correction d’un problème où le déploiement d’une modification dans une table externe entraîne la suppression et la recréation de toutes les tables externes si la table modifiée ne contenait aucune valeur pour REJECT_VALUE ou REJECT_SAMPLE_VALUE.	Interface en ligne de commande SqlPackage ; API DacFx / Comparaison de schémas
Deployment	Correction d’un problème où la modification d’une colonne pour développer sa longueur entraîne un avertissement de perte de données incorrect si le classement de la colonne est spécifié et correspond au classement par défaut de la base de données. Problème GitHub	Interface en ligne de commande SqlPackage ; API DacFx / Comparaison de schémas
Deployment	Correction d'un problème où les modifications de la classification de sensibilité sur une table entraînent la recréation des index. Problème GitHub	Interface en ligne de commande SqlPackage ; API DacFx / Comparaison de schémas
Export	Optimisé l’utilisation de l’estimation de taille de table pendant les opérations d’exportation.	SqlPackage CLI
Extract	Correction d’un problème où l’extraction d’une .dacpac référence de base de données échoue. Problème GitHub	Interface en ligne de commande SqlPackage ; API DacFx / Comparaison de schémas
Entrepôt de données Fabric	Correction d’un problème où la sp_refreshsqlmodule procédure stockée système est appelée pendant une opération de publication. Fabric Data Warehouse ne prend pas en charge sp_refreshsqlmodule et cela entraîne l’échec du déploiement.	SqlPackage CLI
Entrepôt de données Fabric	Correction d’un problème où les contraintes de table sont incluses dans les fichiers .dacpac mais pas dans les fichiers .sql lors de l'extraction d'une base de données d'un entrepôt de données Fabric. Problème GitHub	SqlPackage CLI
Projets SQL	Correction d’un problème où la génération sans SSDT installée dans Visual Studio entraîne un comportement de génération incorrect. Problème GitHub	Projets MSBuild / SQL
Projets SQL	Correction d’un problème où les avertissements de build sont dupliqués dans la sortie lorsque l’analyse du code est activée. Problème GitHub	Projets MSBuild / SQL
Projets SQL	Correction d’un problème où les paramètres service Broker définis sur des variables entraînent des faux avertissements. Problème GitHub	Projets MSBuild / SQL

Versions archivées (162.x et versions antérieures)

Vous trouverez des notes de publication pour la version 162.x et les versions antérieures dans les notes de publication de SqlPackage (archive).