Aktuelle Version herunterladen
In diesem Artikel werden die in den veröffentlichten Versionen von SqlPackage bereitgestellten Features und Fixes aufgelistet.
Wie man diese Versionshinweise liest
Die Spalte "Gilt für" in den einzelnen Abschnitten ist wie folgt festgelegt:
-
SqlPackage CLI - Befehlszeilenaktionen (Veröffentlichen, Importieren, Exportieren, Extrahieren, Parquet, Diagnose, dotnet-Tool)
-
MSBuild / SQL-Projekte - SQL-Projektbuild (
Microsoft.Build.Sql SDK, SQL Server Data Tools (SSDT)-Integration)
-
DacFx-API / Schemavergleich -
Microsoft.SqlServer.DacFx NuGet-APIs, Schemavergleich
-
Plattform – ScriptDom, Microsoft.Data.SqlClient, .NET-Unterstützung, System DACPACs, Kompatibilitätsstandardwerte
Aktuelle Versionen (170.x)
Die folgenden Versionen sind die derzeit unterstützten Versionen von SqlPackage.
170.4.83.3 SqlPackage
Veröffentlichungsdatum: 3. Juni 2026
dotnet tool install -g microsoft.sqlpackage --version 170.4.83.3
Features
| Feature |
Details |
Gilt für: |
| Datenbankoption |
Unterstützung für Datenbankoption AUTOMATIC_INDEX_COMPACTIONhinzugefügt.
Dokumentation zur automatischen Indexkomprimierung |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Dynamische Datenmaskierung |
Unterstützung für die dynamische Datenmaskierung bei den Extraktions- und Veröffentlichungsvorgängen für Data Warehouse in Microsoft Fabric hinzugefügt. |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Extract |
Unterstützung zum Extrahieren einer Datenbank in das SQL-Projektformat hinzugefügt.
GitHub-Problem |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Platform |
Verweise auf Microsoft.Data.SqlClient v6.1.5. |
Platform |
| ScriptDom |
ScriptDom wurde auf Version 180.18.1 aktualisiert. |
Platform |
Fixes
| Feature |
Details |
Gilt für: |
| Deployment |
Bereitstellungsfehler behoben, die dadurch verursacht wurden, dass eine schemagebundene Funktion ALTER TABLE-Vorgänge blockierte. |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Deployment |
Es wurde ein Problem behoben, bei dem externe Modellbesitzerinformationen beim Bereitstellen in einer Datenbank beibehalten werden. |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Deployment |
Ein Problem bei der Bereitstellung einer Tabelle mit CLUSTER BY in ein Data Warehouse in Microsoft Fabric wurde behoben. |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Deployment |
Es wurde ein Problem beim Bereitstellen einer Tabelle mit IDENTITY einer Spalte in einem Data Warehouse in Microsoft Fabric behoben. |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Deployment |
Es wurde ein Problem behoben, bei dem während der Bereitstellung nach einer DacPac-Datei in Großbuchstaben gesucht wurde, wodurch die Bereitstellung in einigen Gebietsschemata, beispielsweise im Türkischen, fehlschlagen konnte.
GitHub-Problem |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Import |
Es wurde ein Problem behoben, bei dem das Einfügen von Daten in Tabellen durch datenbank- und DDL-Trigger den Importvorgang beeinträchtigen konnte. |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Schemavergleich |
Es wurde ein Problem behoben, bei dem das Erhöhen der Länge eines Varchar-Felds zu einer Warnung zum Datenverlust führt, und eine Überprüfung, die fehlschlägt, wenn Zeilen vorhanden sind.
GitHub-Problem |
SqlPackage CLI; DacFx-API / Schemavergleich |
| SQL-Projekte |
Ein Fehler beim Generieren von SQL-Dateien aus einem Projekt in Nicht-Windows Computern wurde behoben. |
MSBuild / SQL-Projekte |
| SQL-Projekte |
Ein Problem wurde behoben, bei dem generierte Skripts, die eine .scmp Datei als Quelle verwenden, unerwünschte SET ANSI_NULLS OFF Befehle enthielten.
GitHub-Problem |
MSBuild / SQL-Projekte; DacFx-API / Schemavergleich |
| Schemavergleich |
Es wurde ein Problem behoben, bei dem die Ausnahmemeldung falsch war, als das TargetScripts Tag in einer .scmp Datei fehlte.
GitHub-Problem |
DacFx-API / Schemavergleich |
| Deployment |
Es wurde ein Problem behoben, bei dem bei der Verwendung von IncludeCompositeObjects=true mit einer SameDatabase-Referenz ein NullReferenceException auftrat.
GitHub-Problem |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Platform |
Die Fehlermeldung beim Angeben eines nicht unterstützten Speichermodells für .NET Core wurde verbessert.
GitHub-Problem |
Plattform; SqlPackage CLI |
| Fabric Data Warehouse |
Es wurde ein Problem behoben, bei dem das Bereitstellen von Tabellen mit IDENTITY Spalten auf Fabric Data Warehouse aufgrund nicht unterstützter SEED oder INCREMENT Syntax fehlgeschlagen ist.
GitHub-Problem |
SqlPackage CLI; DacFx-API / Schemavergleich |
170.3.93 SqlPackage
Veröffentlichungsdatum: 10. Februar 2026
dotnet tool install -g microsoft.sqlpackage --version 170.3.93
Features
| Feature |
Details |
Gilt für: |
| Deployment |
Unterstützung für Datenbankoptionen ACCELERATED_DATABASE_RECOVERY und OPTIMIZED_LOCKING hinzugefügt. |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Permissions |
Verbessert die Veröffentlichung von Berechtigungen, um EXECUTE ON EXTERNAL MODEL Berechtigungen einzuschließen. |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Platform |
.NET 10-Unterstützung zur DacFx-Bibliothek und der SqlPackage CLI hinzugefügt. Das SqlPackage dotnet tool ist sowohl für .NET 8 als auch für .NET 10 verfügbar. |
Plattform; SqlPackage CLI; DacFx-API / Schemavergleich |
| Platform |
.NET Standard 2.0-Unterstützung zur DacFx-Bibliothek hinzugefügt. |
Plattform; DacFx-API / Schemavergleich |
| Platform |
Verweist auf Microsoft.Data.SqlClient v6.1.3. |
Platform |
| ScriptDom |
ScriptDom wurde auf Version 170.157.0 aktualisiert. |
Platform |
| Vector |
Erweitert die Unterstützung von Vektorspalten, um das Ändern des Basistyps zu ermöglichen. |
SqlPackage CLI; MSBuild / SQL-Projekte; DacFx-API / Schemavergleich |
Fixes
| Feature |
Details |
Gilt für: |
| Deployment |
Ein Fehler beim Bereitstellen in der SQL-Datenbank in Microsoft Fabric wurde behoben, wenn die Zieldatenbank eine Sicherheitsrichtlinie enthält. |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Export |
Ein Problem wurde behoben, bei dem bei exportierten .dacpac Dateien die XSD-Schemaüberprüfung aufgrund boolescher Attributwerte mitTrue/FalseWerten anstelle von Kleinbuchstaben true/falsefehlschlug.
GitHub-Problem |
SqlPackage CLI |
| Import |
Es wurde ein Problem behoben, bei dem beim Importieren einer Tabelle mit Sonderzeichen im Namen (z. B. /, " oder $) keine Daten importiert werden, ohne den Benutzer zu warnen.
GitHub-Problem |
SqlPackage CLI |
| Ledger |
Es wurde ein Problem behoben, bei dem eine Hauptbuchstabelle mit einer berechneten Spalte während der Modellüberprüfung und -erstellung ein NullReferenceException verursachte.
GitHub-Problem |
MSBuild / SQL-Projekte; DacFx-API / Schemavergleich |
| SQL-Projekte |
Es wurde ein Problem behoben, bei dem das Erstellen eines SQL-Projekts mit einer Inline-Indexdefinition für gruppierte Spalten in einer Tabelle mit einem Syntaxfehler fehlschlägt.
GitHub-Problem |
MSBuild / SQL-Projekte |
| SQL-Projekte |
Es wurde ein Problem behoben, bei dem ein gruppierter Columnstore-Index in einer Tabelle mit NVARCHAR(MAX) oder anderen LOB-Spalten fälschlicherweise einen Fehler meldet, dass Columnstore-Indizes nicht mit Vektor-Spalten unterstützt werden.
GitHub-Problem |
MSBuild / SQL-Projekte |
| Vector |
Es wurde ein Problem behoben, bei dem Prozeduren mit VECTOR_SEARCH eine Validierungswarnung meldeten, dass der Spaltenverweis nicht aufgelöst werden konnte.
GitHub-Problem |
MSBuild / SQL-Projekte; DacFx-API / Schemavergleich |
170.2.70 SqlPackage
Erscheinungsdatum: 14. Oktober 2025
dotnet tool install -g microsoft.sqlpackage --version 170.2.70
Features
| Feature |
Details |
Gilt für: |
| Externe Modelle |
Unterstützung für externe Modelle in Azure SQL-Datenbank und SQL Server 2025 (17.x) zum Importieren, Exportieren, Extrahieren, Bereitstellen und SQL-Projektbuild hinzugefügt. |
SqlPackage CLI; MSBuild / SQL-Projekte; DacFx-API / Schemavergleich |
| Externe Modelle |
Unterstützung für die Funktionen AI_GENERATE_CHUNKS und AI_GENERATE_EMBEDDINGS wurde hinzugefügt. |
SqlPackage CLI; DacFx-API / Schemavergleich |
| JSON |
Unterstützung für JSON-Indizes in Azure SQL-Datenbank und SQL Server 2025 (17.x) zum Importieren, Exportieren, Extrahieren, Bereitstellen und SQL-Projektbuild hinzugefügt. |
SqlPackage CLI; MSBuild / SQL-Projekte; DacFx-API / Schemavergleich |
| JSON |
Unterstützung für JSON-Funktionen JSON_ARRAYAGG, JSON_OBJECTAGGund JSON_QUERYhinzugefügt . |
SqlPackage CLI; MSBuild / SQL-Projekte; DacFx-API / Schemavergleich |
| Platform |
Das SqlPackage-Build .zip .NET SDK wird auf 8.0.414 aktualisiert. |
Plattform; SqlPackage CLI |
| Regex |
Unterstützung für die REGEXP_LIKE Funktion hinzugefügt. |
SqlPackage CLI; MSBuild / SQL-Projekte; DacFx-API / Schemavergleich |
| ScriptDom |
ScriptDom wurde auf Version 170.128.0 aktualisiert. |
Platform |
| Vector |
Unterstützung für die Vektorindizes in Azure SQL-Datenbank und SQL Server 2025 (17.x) zum Importieren, Exportieren, Extrahieren, Bereitstellen und SQL-Projektbuild hinzugefügt. |
SqlPackage CLI; MSBuild / SQL-Projekte; DacFx-API / Schemavergleich |
| Vector |
Erweitert die Unterstützung für den Vektordatentyp auf SQL Server 2025 (17.x) und gibt die 32-Bit-Float-Größe an. |
SqlPackage CLI; MSBuild / SQL-Projekte; DacFx-API / Schemavergleich |
| Vector |
Unterstützung für die Vector-Funktion VECTOR_SEARCHhinzugefügt. |
SqlPackage CLI; MSBuild / SQL-Projekte; DacFx-API / Schemavergleich |
Fixes
| Feature |
Details |
Gilt für: |
| Datenmaskierung |
Es wurde ein Problem behoben, bei dem die Datetime-Datenmaskierungsfunktionen während des Erstellens des Projekts nicht erkannt wurden.
GitHub-Problem |
MSBuild / SQL-Projekte |
| Externe Modelle |
Es wurde ein Problem behoben, bei dem externe Modellabhängigkeiten von Anmeldeinformationen, die sich auf den Datenbankbereich beziehen, dazu führen, dass der Projektbuild fehlschlägt. |
MSBuild / SQL-Projekte |
| JSON |
Ein Fehler beim Vergleichen von JSON-Indizes mit dem standardmäßigen JSON-Pfad wurde behoben. |
DacFx-API / Schemavergleich; SqlPackage CLI |
| Platform |
Verweist auf Microsoft.Data.SqlClient v5.1.7. |
Platform |
| XML |
Es wurde ein Problem behoben, bei dem der XML-Abfragepfad (xQuery) während des Modellvergleichs ohne Berücksichtigung der Groß-/Kleinschreibung behandelt wurde. Auch bei Datenbanken ohne Unterscheidung zwischen Groß- und Kleinschreibung wird beim xQuery-Pfad die Groß- und Kleinschreibung beachtet.
GitHub-Problem |
DacFx-API / Schemavergleich; SqlPackage CLI |
170.1.61 SqlPackage
Erscheinungsdatum: 30. Juli 2025
dotnet tool install -g microsoft.sqlpackage --version 170.1.61
Features
| Feature |
Details |
Gilt für: |
| Datenvirtualisierung |
Unterstützung für Objekte im Zusammenhang mit der Datenvirtualisierung für Azure SQL-Datenbank in Import-, Export-, Extrakt- und Veröffentlichungsvorgängen hinzugefügt. |
SqlPackage CLI |
| Datenvirtualisierung |
Die Azure SQL-Datenbank wurde der Vorschaufunktion für das Veröffentlichen von Parquet-Dateien hinzugefügt, wodurch die Verwendung von Azure Blob Storage und Parquet-Dateien zum Importieren von Daten in eine Datenbank ermöglicht wird. Das Extrahieren von Daten in Parkettdateien ist für Azure SQL-Datenbank nicht verfügbar, da es von der Funktionalität abhängt, die CREATE EXTERNAL TABLE AS SELECT ist. |
SqlPackage CLI |
| Deployment |
Unterstützung für Veröffentlichungseigenschaften /p:IgnorePreDeployScript und /p:IgnorePostDeployScript hinzugefügt. Diese Eigenschaften haben standardmäßig den Wert false und wenn sie aktiviert sind, führt dies dazu, dass der Bereitstellungsplan die entsprechenden Skripte weglässt.
GitHub-Problem |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Permissions |
Für die Berechtigung ALTER ANY EXTERNAL MIRROR in der Azure SQL-Datenbank und der SQL-Datenbank in Microsoft Fabric wurde die Unterstützung hinzugefügt. Diese Berechtigung ist erforderlich, um eine Datenbank zu exportieren, die mindestens eine gespiegelte Tabelle enthält.
GitHub-Problem |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Permissions |
Unterstützung für die Berechtigungen CREATE ANY EXTERNAL MODEL und ALTER ANY EXTERNAL MODEL für SQL Server 2025 (17.x) hinzugefügt. |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Permissions |
Unterstützung für die Berechtigung ALTER ANY INFORMATION PROTECTION für SQL Server 2025 (17.x) und Azure SQL-Datenbank hinzugefügt. |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Platform |
Das SqlPackage-Build .zip .NET SDK wird auf 8.0.412 aktualisiert. |
Plattform; SqlPackage CLI |
| ScriptDom |
ScriptDom wurde auf Version 170.0.64 aktualisiert. |
Platform |
| ScriptDom |
Aktualisiert das Data Warehouse in der Fabric-Plattform, um in ScriptDom zu verwenden. |
Plattform; DacFx-API / Schemavergleich |
Fixes
| Feature |
Details |
Gilt für: |
| Immer Verschlüsselt |
Es wurde ein Problem behoben, bei dem die Interactive Option für den Veröffentlichungsparameter /AzureKeyVaultAuthMethod nicht ordnungsgemäß funktionierte. |
SqlPackage CLI |
| Deployment |
Es wurde ein Problem behoben, bei dem die DbScopedConfigMaxDOPSecondary in der Bereitstellung nicht ordnungsgemäß festgelegt wurde.
GitHub-Problem |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Deployment |
Ein Problem wurde behoben, bei dem das Veröffentlichen von Tabellen mit Fremdschlüsseleinschränkungen aufgrund einer in Microsoft Fabric Data Warehouse nicht unterstützten Syntax fehlschlug. |
SqlPackage CLI |
| Deployment |
Es wurde ein Problem behoben, bei dem Serverobjekte beim Bereitstellen in der SQL-Datenbank in Microsoft Fabric enthalten waren. Serverobjekte werden in der SQL-Datenbank in Microsoft Fabric nicht unterstützt.
GitHub-Problem |
SqlPackage CLI |
| Deployment |
Es wurde ein Problem behoben, bei dem gruppierte Spaltenspeicherindizes erstellt wurden, indem zuerst ein gruppierter Index erstellt wurde, wodurch der Bereitstellungsaufwand und die Bereitstellungszeit erhöht werden.
GitHub-Problem |
SqlPackage CLI |
| Extract |
Es wurde ein Problem behoben, bei dem das Extrahieren einer Datenbank aus einer SQL-Datenbank in Microsoft Fabric zu unbrauchbaren Benutzerdefinitionsskripts führt.
GitHub-Problem |
SqlPackage CLI |
170.0.94 SqlPackage
Erscheinungsdatum: 15. April 2025
dotnet tool install -g microsoft.sqlpackage --version 170.0.94
Features
| Feature |
Details |
Gilt für: |
| DACPACVerify |
Unterstützung für die Überprüfung des Inhalts von zwei .dacpac Dateien wurde im Vorschautool Microsoft.DacpacVerify hinzugefügt. |
DacFx-API / Schemavergleich |
| Extract |
Unterstützung zum Entpacken einer .dacpac Datei in einen Ordner hinzugefügt. Der /Action:Extract-Befehl wird mit den Parametern /SourceFile: und /TargetFile: verwendet. Bei der Zieldatei muss es sich um einen Ordner handeln, und wenn eine Quelldatei (.dacpac) angegeben wird, sind keine Datenbankverbindungseigenschaften gültig. Die Eigenschaft /p:ExtractTarget=SchemaObjectType ist erforderlich, um aus einer .dacpac Datei anstelle einer Quelldatenbank zu extrahieren. Die ausführbare Datei Dacunpack.exe wird aus dem DacFx.msi Installationsprogramm entfernt. |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Parquet |
Unterstützung für die Datentypen Timestamp, Rowversion, UniqueIdentifier, Text, ntext, image, json, xml und vector bei Verwendung von Parkettdateien in Azure Blob Storage mit SqlPackage-Extrakt- und Veröffentlichungsvorgängen hinzugefügt. |
SqlPackage CLI |
| Parquet |
Unterstützung für das Exportieren und Importieren von Tabellendaten in BCP-Dateien hinzugefügt, wenn die Tabelle einen nicht unterstützten Datentyp enthält. Parquet-Dateien werden in Azure Blob Storage für die verbleibenden Daten bei SqlPackage-Extrakt- und Veröffentlichungsvorgängen verwendet. Ein Beispieldatentyp ist sql_variant, und eine Tabelle, die eine Spalte dieses Typs enthält, wird in BCP .dacpac geschrieben, während die verbleibenden Tabellen als Parquet-Dateien in Azure Blob Storage geschrieben werden. |
SqlPackage CLI |
| Platform |
Die Version von SqlPackage für .NET Framework wurde auf .NET Framework 4.7.2 aktualisiert. |
Plattform; SqlPackage CLI |
| Platform |
Die Unterstützung für .NET 6 wurde entfernt. |
Plattform; SqlPackage CLI |
| ScriptDom |
ScriptDom wurde auf Version 170.18.0 aktualisiert. |
Platform |
| SQL-Projekte |
Die Standardkompatibilitätsstufe für Azure SQL-Datenbank und SQL-Datenbank in Microsoft Fabric ist jetzt auf 170 festgelegt. Weitere Informationen finden Sie unter Datenbank-Kompatibilitätsgrad 170 in Azure SQL-Datenbank und SQL-Datenbank in Microsoft Fabric. |
MSBuild / SQL-Projekte |
| Vector |
Der Vektordatentyp wird jetzt auf der Zielplattform Azure SQL-Datenbank für Import, Export, Extraktion, Bereitstellung und SQL-Projekterstellung unterstützt. |
SqlPackage CLI; MSBuild / SQL-Projekte; DacFx-API / Schemavergleich |
Fixes
| Feature |
Details |
Gilt für: |
| Deployment |
Es wurde ein Problem behoben, bei dem das Bereitstellen einer Änderung an einer externen Tabelle dazu führt, dass alle externen Tabellen gelöscht und neu erstellt werden, wenn die geänderte Tabelle keine Werte für REJECT_VALUE oder REJECT_SAMPLE_VALUE enthält. |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Deployment |
Es wurde ein Problem behoben, bei dem das Ändern einer Spalte zum Erweitern der Länge zu einer falschen Warnung zum Datenverlust führt, wenn die Sortierung der Spalte angegeben ist und der Standardsortierung der Datenbank entspricht.
GitHub-Problem |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Deployment |
Es wurde ein Problem behoben, bei dem Änderungen an der Vertraulichkeitsklassifizierung in einer Tabelle dazu führen, dass Indizes neu erstellt werden.
GitHub-Problem |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Export |
Die Verwendung der Tabellengrößenschätzung bei Exportvorgängen wurde optimiert. |
SqlPackage CLI |
| Extract |
Es wurde ein Problem behoben, bei dem das Extrahieren eines .dacpac mit einem Datenbankverweis fehlschlägt.
GitHub-Problem |
SqlPackage CLI; DacFx-API / Schemavergleich |
| Fabric Data Warehouse |
Es wurde ein Problem behoben, bei dem die sp_refreshsqlmodule gespeicherte Systemprozedur während eines Veröffentlichungsvorgangs aufgerufen wird. Fabric Data Warehouse unterstützt sp_refreshsqlmodule nicht, und dies führt dazu, dass die Bereitstellung fehlschlägt. |
SqlPackage CLI |
| Fabric Data Warehouse |
Es wurde ein Problem behoben, bei dem Tabelleneinschränkungen in .dacpac-Dateien enthalten sind, aber nicht in .sql-Dateien, wenn eine Datenbank aus einem Fabric Data Warehouse extrahiert wurde.
GitHub-Problem |
SqlPackage CLI |
| SQL-Projekte |
Es wurde ein Problem behoben, bei dem das Erstellen ohne in Visual Studio installierte SSDT zu einem falschen Buildverhalten führt.
GitHub-Problem |
MSBuild / SQL-Projekte |
| SQL-Projekte |
Ein Problem wurde behoben, bei dem Buildwarnungen in der Ausgabe dupliziert werden, wenn die Codeanalyse aktiviert ist.
GitHub-Problem |
MSBuild / SQL-Projekte |
| SQL-Projekte |
Ein Problem wurde behoben, bei dem durch das Festlegen von Dienstbroker-Parametern auf Variablen fälschlicherweise Warnungen ausgelöst wurden.
GitHub-Problem |
MSBuild / SQL-Projekte |
Archivierte Versionen (162.x und frühere Versionen)
Versionshinweise für Version 162.x und ältere Versionen finden Sie in den Versionshinweisen für SqlPackage (Archiv).