Freigeben über

Versionshinweise zu SqlPackage

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.3.93 SqlPackage

Veröffentlichungsdatum: 10. Februar 2026

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

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
Platform Download
Windows .NET 8 .zip-Datei
Windows .msi-Datei
macOS .NET 8 .zip-Datei
Linux .NET 8 .zip-Datei

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
Platform Download
Windows .NET 8 .zip-Datei
Windows .msi-Datei
macOS .NET 8 .zip-Datei
Linux .NET 8 .zip-Datei

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
Platform Download
Windows .NET 8 .zip-Datei
Windows .msi-Datei
macOS .NET 8 .zip-Datei
Linux .NET 8 .zip-Datei

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 Database 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).

  • Last updated on