Condividi tramite

Note di rilascio per SqlPackage

Scaricare la versione più recente

Questo articolo elenca le funzionalità e le correzioni distribuite con le versioni rilasciate di SqlPackage.

Come leggere queste note sulla versione

La colonna Si applica a in ogni sezione ha il seguente ambito:

  • Interfaccia della riga di comando di SqlPackage : azioni della riga di comando (pubblicazione, importazione, esportazione, estrazione, Parquet, diagnostica, strumento dotnet)
  • PROGETTI MSBuild/SQL - Compilazione del progetto SQL (Microsoft.Build.Sql SDK, integrazione di SQL Server Data Tools (SSDT)
  • Confronto - Microsoft.SqlServer.DacFx API NuGet, confronto dello schema
  • Platform - ScriptDom, Microsoft.Data.SqlClient, supporto .NET, DACPAC di sistema, impostazioni predefinite di compatibilità

Versioni correnti (170.x)

Le versioni seguenti sono le versioni attualmente supportate di SqlPackage.

170.3.93 SqlPackage

Data di rilascio: 10 febbraio 2026

dotnet tool install -g microsoft.sqlpackage --version 170.3.93
Platform Download
Windows .NET 10 .zip file
Windows .msi file
macOS .NET 10 .zip file
Linux .NET 10 .zip file

Features

Feature Details Si applica a
Deployment Aggiunta del supporto per le opzioni di database ACCELERATED_DATABASE_RECOVERY e OPTIMIZED_LOCKING. Interfaccia della riga di comando di SqlPackage; Confronto tra l'API DacFx e lo schema
Permissions Migliora la pubblicazione delle autorizzazioni per includere EXECUTE ON EXTERNAL MODEL. Interfaccia della riga di comando di SqlPackage; Confronto tra l'API DacFx e lo schema
Platform Aggiunta del supporto di .NET 10 alla libreria DacFx e all'interfaccia della riga di comando di SqlPackage. SqlPackage dotnet tool è disponibile sia per .NET 8 che per .NET 10. Piattaforma; Interfaccia della riga di comando di SqlPackage; Confronto tra l'API DacFx e lo schema
Platform Aggiunta del supporto di .NET Standard 2.0 alla libreria DacFx. Piattaforma; Confronto tra l'API DacFx e lo schema
Platform Fa riferimento a Microsoft.Data.SqlClient v6.1.3. Platform
ScriptDom Aggiornamento di ScriptDom alla versione 170.157.0. Platform
Vector Estende il supporto delle colonne vettoriali per consentire la modifica del tipo di base. Interfaccia della riga di comando di SqlPackage; PROGETTI MSBuild/SQL; Confronto tra l'API DacFx e lo schema

Fixes

Feature Details Si applica a
Deployment Correzione di un bug relativo alla distribuzione nel database SQL in Microsoft Fabric quando il database di destinazione include criteri di sicurezza. Interfaccia della riga di comando di SqlPackage; Confronto tra l'API DacFx e lo schema
Export È stato risolto un problema per cui i file esportati .dacpac non superano la convalida dello schema XSD a causa dell'uso di valori di attributo booleani con True/False al posto di quelli in minuscolo true/false. Problema di GitHub Interfaccia a riga di comando SqlPackage (CLI)
Import È stato risolto un problema a causa del quale l'importazione di una tabella con caratteri speciali nel nome (ad /esempio , "o $) non riesce a importare i dati senza avvisare l'utente. Problema di GitHub Interfaccia a riga di comando SqlPackage (CLI)
Ledger È stato risolto un problema per cui una tabella del libro mastro con una colonna calcolata causava un NullReferenceException durante la convalida e la compilazione del modello. Problema di GitHub PROGETTI MSBuild/SQL; Confronto tra l'API DacFx e lo schema
Progetti SQL È stato risolto un problema per cui la compilazione di un progetto SQL con una definizione di indice columnstore con cluster inline in una tabella fallisce con un errore di sintassi. Problema di GitHub Progetti MSBuild/SQL
Progetti SQL È stato risolto un problema per cui un indice columnstore raggruppato in una tabella con NVARCHAR(MAX) o altre colonne di tipo LOB segnala erroneamente un errore in cui si indica che gli indici columnstore non sono supportati con colonne vettoriali. Problema di GitHub Progetti MSBuild/SQL
Vector È stato risolto un problema a causa del quale le procedure che usano VECTOR_SEARCH segnalano un avviso di convalida che indica che non è stato possibile risolvere il riferimento alla colonna. Problema di GitHub PROGETTI MSBuild/SQL; Confronto tra l'API DacFx e lo schema

170.2.70 SqlPackage

Data di rilascio: 14 ottobre 2025

dotnet tool install -g microsoft.sqlpackage --version 170.2.70
Platform Download
Windows .NET 8 .zip file
Windows .msi file
macOS .NET 8 .zip file
Linux .NET 8 .zip file

Features

Feature Details Si applica a
Modelli esterni Aggiunta del supporto per i modelli esterni nel database SQL di Azure e SQL Server 2025 (17.x) per l'importazione, l'esportazione, l'estrazione, la distribuzione e la compilazione del progetto SQL. Interfaccia della riga di comando di SqlPackage; PROGETTI MSBuild/SQL; Confronto tra l'API DacFx e lo schema
Modelli esterni Aggiunta del supporto per le funzioni AI_GENERATE_CHUNKS e AI_GENERATE_EMBEDDINGS. Interfaccia della riga di comando di SqlPackage; Confronto tra l'API DacFx e lo schema
JSON Aggiunta del supporto per gli indici JSON nel database SQL di Azure e SQL Server 2025 (17.x) per l'importazione, l'esportazione, l'estrazione, la distribuzione e la compilazione del progetto SQL. Interfaccia della riga di comando di SqlPackage; PROGETTI MSBuild/SQL; Confronto tra l'API DacFx e lo schema
JSON Aggiunta del supporto per le funzioni JSON JSON_ARRAYAGG, JSON_OBJECTAGG e JSON_QUERY. Interfaccia della riga di comando di SqlPackage; PROGETTI MSBuild/SQL; Confronto tra l'API DacFx e lo schema
Platform SqlPackage .zip build .NET SDK viene aggiornato alla versione 8.0.414 Piattaforma; Interfaccia della riga di comando di SqlPackage
Regex (Espressione regolare) Step 2: Aggiunta del supporto per la funzione REGEXP_LIKE. Interfaccia della riga di comando di SqlPackage; PROGETTI MSBuild/SQL; Confronto tra l'API DacFx e lo schema
ScriptDom Aggiornamento di ScriptDom alla versione 170.128.0. Platform
Vector Aggiunta del supporto per gli indici vettoriali nel database SQL di Azure e SQL Server 2025 (17.x) per l'importazione, l'esportazione, l'estrazione, la distribuzione e la compilazione del progetto SQL. Interfaccia della riga di comando di SqlPackage; PROGETTI MSBuild/SQL; Confronto tra l'API DacFx e lo schema
Vector Espande il supporto per il tipo di dati vector a SQL Server 2025 (17.x) e specifica le dimensioni float a 32 bit. Interfaccia della riga di comando di SqlPackage; PROGETTI MSBuild/SQL; Confronto tra l'API DacFx e lo schema
Vector Aggiunto supporto alla funzione Vector VECTOR_SEARCH. Interfaccia della riga di comando di SqlPackage; PROGETTI MSBuild/SQL; Confronto tra l'API DacFx e lo schema

Fixes

Feature Details Si applica a
Mascheramento dei dati È stato risolto un problema per cui le funzioni di maschera dati datetime non venivano riconosciute durante la compilazione del progetto. Problema di GitHub Progetti MSBuild/SQL
Modelli esterni È stato risolto un problema a causa del quale le dipendenze del modello esterno da credenziali con ambito database causano l'esito negativo della compilazione del progetto. Progetti MSBuild/SQL
JSON Correzione di un bug durante il confronto degli indici JSON con il percorso JSON predefinito. Confronto tra l'API DacFx e lo schema; Interfaccia della riga di comando di SqlPackage
Platform Fa riferimento a Microsoft.Data.SqlClient v5.1.7. Platform
XML È stato risolto un problema per cui il percorso di query XML (xQuery) non veniva considerato come case-sensitive durante il confronto tra modelli. Anche nei database senza distinzione tra maiuscole e minuscole, il percorso xQuery fa distinzione tra maiuscole e minuscole. Problema di GitHub Confronto tra l'API DacFx e lo schema; Interfaccia della riga di comando di SqlPackage

170.1.61 SqlPackage

Data di rilascio: 30 luglio 2025

dotnet tool install -g microsoft.sqlpackage --version 170.1.61
Platform Download
Windows .NET 8 .zip file
Windows .msi file
macOS .NET 8 .zip file
Linux .NET 8 .zip file

Features

Feature Details Si applica a
Virtualizzazione dei dati Aggiunta del supporto per gli oggetti correlati alla virtualizzazione dei dati per il database SQL di Azure nelle operazioni di importazione, esportazione, estrazione e pubblicazione. Interfaccia a riga di comando SqlPackage (CLI)
Virtualizzazione dei dati Aggiunto Azure SQL Database alla pubblicazione con l'anteprima dei file parquet, consentendo l'uso di Azure Blob Storage e dei file parquet per importare i dati in un database. L'estrazione di dati in file parquet non è disponibile per il database SQL di Azure perché dipende dalla funzionalità non disponibile nel database SQL di Azure, CREATE EXTERNAL TABLE AS SELECT. Interfaccia a riga di comando SqlPackage (CLI)
Deployment Aggiunto il supporto per le proprietà di pubblicazione /p:IgnorePreDeployScript e /p:IgnorePostDeployScript. Queste proprietà sono predefinite false e, se abilitate, comportano l'omissione degli script corrispondenti nel piano di distribuzione. Problema di GitHub Interfaccia della riga di comando di SqlPackage; Confronto tra l'API DacFx e lo schema
Permissions Aggiunta del supporto per l'autorizzazione ALTER ANY EXTERNAL MIRROR per il database SQL di Azure e il database SQL in Microsoft Fabric. Questa autorizzazione è necessaria per esportare un database contenente una o più tabelle con mirroring. Problema di GitHub Interfaccia della riga di comando di SqlPackage; Confronto tra l'API DacFx e lo schema
Permissions Aggiunta del supporto per le autorizzazioni CREATE ANY EXTERNAL MODEL e ALTER ANY EXTERNAL MODEL per SQL Server 2025 (17.x). Interfaccia della riga di comando di SqlPackage; Confronto tra l'API DacFx e lo schema
Permissions Aggiunta del supporto per l'autorizzazione ALTER ANY INFORMATION PROTECTION per SQL Server 2025 (17.x) e il database SQL di Azure. Interfaccia della riga di comando di SqlPackage; Confronto tra l'API DacFx e lo schema
Platform SqlPackage .zip build .NET SDK viene aggiornato alla versione 8.0.412. Piattaforma; Interfaccia della riga di comando di SqlPackage
ScriptDom Aggiornamento di ScriptDom alla versione 170.0.64. Platform
ScriptDom Aggiorna il data warehouse della piattaforma Fabric per utilizzare TSqlFabricDWParser in ScriptDom. Piattaforma; Confronto tra l'API DacFx e lo schema

Fixes

Feature Details Si applica a
Sempre Crittografato È stato risolto un problema per cui l'opzione Interactive per il /AzureKeyVaultAuthMethod parametro di pubblicazione non funzionava correttamente. Interfaccia a riga di comando SqlPackage (CLI)
Deployment È stato risolto un problema per cui la DbScopedConfigMaxDOPSecondaryproprietà non era impostata correttamente nell'implementazione. Problema di GitHub Interfaccia della riga di comando di SqlPackage; Confronto tra l'API DacFx e lo schema
Deployment È stato risolto un problema per cui la pubblicazione di tabelle contenenti vincoli di chiave esterna ha esito negativo e la sintassi non è supportata in Data Warehouse in Microsoft Fabric. Interfaccia a riga di comando SqlPackage (CLI)
Deployment È stato risolto un problema per cui gli oggetti server venivano inclusi durante la distribuzione nel database SQL in Microsoft Fabric. Gli oggetti server non sono supportati nel database SQL in Microsoft Fabric. Problema di GitHub Interfaccia a riga di comando SqlPackage (CLI)
Deployment È stato risolto un problema per cui gli indici columnstore cluster vengono creati creando prima un indice cluster, aumentando il sovraccarico e il tempo di distribuzione. Problema di GitHub Interfaccia a riga di comando SqlPackage (CLI)
Extract È stato risolto un problema per cui l'estrazione di un database dal database SQL in Microsoft Fabric genera script di definizione utente inutilizzabili. Problema di GitHub Interfaccia a riga di comando SqlPackage (CLI)

170.0.94 SqlPackage

Data di uscita: 15 aprile 2025

dotnet tool install -g microsoft.sqlpackage --version 170.0.94
Platform Download
Windows .NET 8 .zip file
Windows .msi file
macOS .NET 8 .zip file
Linux .NET 8 .zip file

Features

Feature Details Si applica a
DACPACVerify Il supporto per la verifica del contenuto di due .dacpac file è stato aggiunto nello strumento di anteprima Microsoft.DacpacVerify. Confronto tra l'API DacFx e lo schema
Extract Aggiunta del supporto per decomprimere un file .dacpac in una cartella. Il comando /Action:Extract viene utilizzato con i parametri /SourceFile: e /TargetFile:. Il file di destinazione deve essere una cartella e quando viene specificato un file di origine (.dacpac) non sono valide le proprietà di connessione al database. La proprietà /p:ExtractTarget=SchemaObjectType è necessaria per l'estrazione da un .dacpac file anziché da un database di origine. L'eseguibile Dacunpack.exe viene rimosso dal DacFx.msi programma di installazione. Interfaccia della riga di comando di SqlPackage; Confronto tra l'API DacFx e lo schema
Parquet Aggiunta del supporto per i tipi di dati timestamp, rowversion, uniqueidentifier, text, ntext, image, json, xml e vector quando si usano file Parquet in Archiviazione BLOB di Azure con operazioni di estrazione e pubblicazione di SqlPackage. Interfaccia a riga di comando SqlPackage (CLI)
Parquet Supporto aggiunto per l'esportazione e l'importazione di dati di tabella in file BCP quando la tabella contiene un tipo di dati non supportato, utilizzando i file Parquet nell'Azure Blob Storage per i dati rimanenti nelle operazioni di estrazione e pubblicazione con SqlPackage. Un tipo di dati di esempio è sql_variant e una tabella contenente una colonna di tale tipo viene scritta in BCP in .dacpac mentre le tabelle rimanenti vengono scritte in file Parquet in Archiviazione BLOB di Azure. Interfaccia a riga di comando SqlPackage (CLI)
Platform Aggiornamento di SqlPackage per la versione di .NET Framework a .NET Framework 4.7.2. Piattaforma; Interfaccia della riga di comando di SqlPackage
Platform Rimozione del supporto per .NET 6. Piattaforma; Interfaccia della riga di comando di SqlPackage
ScriptDom Aggiornato ScriptDom alla versione 170.18.0. Platform
Progetti SQL Il livello di compatibilità predefinito per il database SQL di Azure e il database SQL in Microsoft Fabric è ora impostato su 170. Per altre informazioni, vedere Livello di compatibilità del database 170 nel database SQL di Azure e Database SQL in Microsoft Fabric. Progetti MSBuild/SQL
Vector Il tipo di dati vettoriale è ora supportato nella piattaforma Azure SQL Database di destinazione per l'importazione, l'esportazione, l'estrazione, la distribuzione e la creazione di progetti SQL. Interfaccia della riga di comando di SqlPackage; PROGETTI MSBuild/SQL; Confronto tra l'API DacFx e lo schema

Fixes

Feature Details Si applica a
Deployment È stato risolto un problema per cui la distribuzione di una modifica in una tabella esterna causava l'eliminazione e la ricreazione di tutte le tabelle esterne se la tabella modificata non conteneva valori per REJECT_VALUE o REJECT_SAMPLE_VALUE. Interfaccia della riga di comando di SqlPackage; Confronto tra l'API DacFx e lo schema
Deployment È stato risolto un problema per cui la modifica di una colonna per espanderne la lunghezza genera un avviso di perdita di dati non corretto se vengono specificate le regole di confronto della colonna e corrisponde alle regole di confronto predefinite del database. Problema di GitHub Interfaccia della riga di comando di SqlPackage; Confronto tra l'API DacFx e lo schema
Deployment È stato risolto un problema in cui le modifiche alla classificazione della sensibilità in una tabella provocavano la ricreazione degli indici. Problema di GitHub Interfaccia della riga di comando di SqlPackage; Confronto tra l'API DacFx e lo schema
Export Ottimizzazione dell'uso della stima delle dimensioni della tabella durante le operazioni di esportazione. Interfaccia a riga di comando SqlPackage (CLI)
Extract È stato risolto un problema a causa del quale l'estrazione di un .dacpac oggetto con un riferimento al database ha esito negativo. Problema di GitHub Interfaccia della riga di comando di SqlPackage; Confronto tra l'API DacFx e lo schema
Data warehouse di Fabric È stato risolto un problema per cui la sp_refreshsqlmodule stored procedure di sistema viene chiamata durante un'operazione di pubblicazione. Fabric Data Warehouse non supporta sp_refreshsqlmodule e ciò causa l'esito negativo della distribuzione. Interfaccia a riga di comando SqlPackage (CLI)
Data warehouse di Fabric È stato risolto un problema per cui i vincoli di tabella sono inclusi in .dacpac ma non nei .sql file quando un database è stato estratto da un data warehouse di Fabric. Problema di GitHub Interfaccia a riga di comando SqlPackage (CLI)
Progetti SQL È stato risolto un problema per cui la compilazione senza SSDT installata in Visual Studio causa un comportamento di compilazione non corretto. Problema di GitHub Progetti MSBuild/SQL
Progetti SQL È stato risolto un problema per cui gli avvisi di compilazione vengono duplicati nell'output quando l'analisi del codice è abilitata. Problema di GitHub Progetti MSBuild/SQL
Progetti SQL È stato risolto un problema per cui i parametri di Service Broker impostati su variabili generano falsi avvisi. Problema di GitHub Progetti MSBuild/SQL

Versioni archiviate (162.x e versioni precedenti)

Le note di rilascio della versione 162.x e delle versioni precedenti sono disponibili nelle note di rilascio per SqlPackage (archivio).

  • Last updated on