Informacje o wersji pakietu SqlPackage

Pobierz najnowszą wersję

W tym artykule wymieniono funkcje i poprawki dostarczone przez wydane wersje pakietu SqlPackage.

Jak przeczytać te notatki o wydaniu

Kolumna Dotyczy w każdej sekcji ma zakres określony w następujący sposób:

• Interfejs wiersza polecenia sqlPackage — akcje wiersza polecenia (publikowanie, importowanie, eksportowanie, wyodrębnianie, Parquet, diagnostyka, narzędzie dotnet)
• Projekty MSBuild/SQL — kompilacja projektu SQL (Microsoft.Build.Sql zestaw SDK, integracja narzędzi SQL Server Data Tools (SSDT)
• DacFx API / porównanie schematów - Microsoft.SqlServer.DacFx API NuGet, porównanie schematów
• Platform — ScriptDom, Microsoft.Data.SqlClient, obsługa .NET, systemowe pakiety DACPAC, domyślne ustawienia zgodności

Bieżące wersje (170.x)

Poniższe wersje to obecnie obsługiwane wersje pakietu SqlPackage.

170.3.93 SqlPackage

Data wydania: 10 lutego 2026 r.

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

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

Features

Feature	Details	Odnosi się do
Deployment	Dodano obsługę opcji ACCELERATED_DATABASE_RECOVERY bazy danych i OPTIMIZED_LOCKING.	Interfejs wiersza polecenia sqlPackage; Interfejs API DacFx / porównanie schematów
Permissions	Udoskonala publikowanie uprawnień, aby uwzględniało EXECUTE ON EXTERNAL MODEL uprawnienia.	Interfejs wiersza polecenia SqlPackage; DacFx API / Porównywanie schematów
Platform	Dodano obsługę platformy .NET 10 do biblioteki DacFx i interfejsu wiersza polecenia sqlPackage. Pakiet SqlPackage dotnet tool jest dostępny zarówno dla platform .NET 8, jak i .NET 10.	Platform; SqlPackage CLI; DacFx API / porównanie schematów
Platform	Dodano obsługę platformy .NET Standard 2.0 do biblioteki DacFx.	Platformy; Interfejs API DacFx / porównanie schematów
Platform	Referencja Microsoft.Data.SqlClient w wersji 6.1.3.	Platform
ScriptDom	Zaktualizowano komponent ScriptDom do wersji 170.157.0.	Platform
Vector	Rozszerza obsługę kolumn wektorowych, aby umożliwić zmianę typu podstawowego.	Interfejs wiersza polecenia sqlPackage; Projekty MSBuild/SQL; Interfejs API DacFx / porównanie schematów

Fixes

Feature	Details	Odnosi się do
Deployment	Usunięto błąd przy wdrażaniu do bazy danych SQL w usłudze Microsoft Fabric, kiedy baza docelowa zawiera politykę zabezpieczeń.	SqlPackage CLI; interfejs DacFx API / porównanie schematów
Export	Rozwiązano problem, w którym wyeksportowane .dacpac pliki nie przechodzą weryfikacji schematu XSD z powodu wartości atrybutów logicznych używających True/False zamiast małych liter true/false. Problem z usługą GitHub	Narzędzie wiersza polecenia SqlPackage
Import	Rozwiązano problem polegający na tym, że importowanie tabeli ze znakami specjalnymi w nazwie (np /. , "lub $) w trybie dyskretnym nie powiodło się bez ostrzeżenia użytkownika. Problem z usługą GitHub	Narzędzie wiersza polecenia SqlPackage
Ledger	Rozwiązano problem, w którym tabela rejestru z obliczoną kolumną powodowała błąd NullReferenceException podczas walidacji i kompilacji modelu. Problem z usługą GitHub	Projekty MSBuild/SQL; Interfejs API DacFx / porównanie schematów
Projekty SQL	Rozwiązano problem polegający na tym, że kompilowanie projektu SQL przy użyciu wbudowanej definicji indeksu magazynu kolumn w klastrze w tabeli kończyło się niepowodzeniem z błędem składniowym. Problem z usługą GitHub	Projekty MSBuild/SQL
Projekty SQL	Rozwiązano problem występujący, gdy indeksowany magazyn kolumn w tabeli zawierającej NVARCHAR(MAX) lub inne kolumny typu LOB niepoprawnie zgłaszał błąd, że indeksy magazynu kolumn nie są obsługiwane w kolumnach wektorowych. Problem z usługą GitHub	Projekty MSBuild/SQL
Vector	Rozwiązano problem polegający na tym, że procedury używające VECTOR_SEARCH raportują ostrzeżenie o walidacji, że nie można rozwiązać odwołania do kolumny. Problem z usługą GitHub	Projekty MSBuild/SQL; Interfejs API DacFx / porównanie schematów

170.2.70 SqlPackage

Data wydania: 14 października 2025 r.

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

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

Features

Feature	Details	Odnosi się do
Modele zewnętrzne	Dodano obsługę modeli zewnętrznych w usługach Azure SQL Database i SQL Server 2025 (17.x) na potrzeby importowania, eksportowania, wyodrębniania, wdrażania i kompilacji projektu SQL.	Interfejs wiersza polecenia SqlPackage; Projekty MSBuild/SQL; interfejs API DacFx / porównanie schematów
Modele zewnętrzne	Dodano obsługę funkcji AI_GENERATE_CHUNKS i AI_GENERATE_EMBEDDINGS.	SqlPackage CLI; DacFx API / porównanie schematów
JSON	Dodano obsługę indeksów JSON w usługach Azure SQL Database i SQL Server 2025 (17.x) na potrzeby importowania, eksportowania, wyodrębniania, wdrażania i kompilacji projektu SQL.	Interfejs wiersza polecenia SqlPackage; Projekty MSBuild/SQL; Interfejs API DacFx / Porównanie schematów
JSON	Dodano obsługę funkcji JSON_ARRAYAGGJSON , JSON_OBJECTAGGi JSON_QUERY.	Interfejs wiersza polecenia SqlPackage; Projekty MSBuild / SQL; Interfejs API DacFx / porównanie schematów
Platform	Zestaw .NET SDK kompilacji SqlPackage .zip został zaktualizowany do wersji 8.0.414	Platforma; Interfejs wiersza polecenia SqlPackage
Regex	Dodano obsługę REGEXP_LIKE funkcji .	Interfejs wiersza polecenia SqlPackage; Projekty MSBuild/SQL; Interfejs API DacFx / porównanie schematów
ScriptDom	Zaktualizowano ScriptDom do wersji 170.128.0.	Platform
Vector	Dodano obsługę indeksów wektorów w usługach Azure SQL Database i SQL Server 2025 (17.x) na potrzeby importowania, eksportowania, wyodrębniania, wdrażania i kompilacji projektu SQL.	Interfejs wiersza polecenia sqlPackage; Projekty MSBuild/SQL; Interfejs API DacFx / porównanie schematów
Vector	Rozszerza obsługę typu danych wektorowych do programu SQL Server 2025 (17.x) i określa rozmiar zmiennoprzecinkowy 32-bitowy.	Interfejs wiersza polecenia SqlPackage; Projekty MSBuild/SQL; Interfejs API DacFx / porównanie schematów
Vector	Dodano obsługę funkcji Vector VECTOR_SEARCH.	CLI SqlPackage; Projekty MSBuild/SQL; DacFx API / Porównanie schematów

Fixes

Feature	Details	Odnosi się do
Maskowanie danych	Rozwiązano problem polegający na tym, że funkcje maskowania danych daty/godziny nie były rozpoznawane podczas kompilacji projektu. Problem z usługą GitHub	Projekty MSBuild/SQL
Modele zewnętrzne	Rozwiązano problem polegający na tym, że zależności modelu zewnętrznego od poświadczeń przypisanych do bazy danych powodują niepowodzenie budowania projektu.	Projekty MSBuild/SQL
JSON	Usunięto usterkę podczas porównywania indeksów JSON z domyślną ścieżką JSON.	API DacFx / porównanie schematów; CLI sqlPackage
Platform	Odnosi się do Microsoft.Data.SqlClient w wersji 5.1.7.	Platform
XML	Rozwiązano problem polegający na tym, że ścieżka zapytania XML (xQuery) nie była traktowana jako uwzględniana wielkość liter podczas porównywania modelu. Nawet w przypadku baz danych niewrażliwych na wielkość liter, ścieżka xQuery uwzględnia wielkość liter. Problem z usługą GitHub	Interfejs API DacFx / Porównanie schematów; Interfejs wiersza polecenia SqlPackage

170.1.61 SqlPackage

Data wydania: 30 lipca 2025 r.

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

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

Features

Feature	Details	Odnosi się do
Wirtualizacja danych	Dodano obsługę obiektów związanych z wirtualizacją danych dla usługi Azure SQL Database w operacjach importowania, eksportowania, wyodrębniania i publikowania.	Narzędzie wiersza polecenia SqlPackage
Wirtualizacja danych	Dodano usługę Azure SQL Database do wersji zapoznawczej funkcji publikowania z użyciem plików parquet, co umożliwia korzystanie z Azure Blob Storage i plików parquet do importowania danych do bazy danych. Wyodrębnianie danych do plików parquet nie jest dostępne dla usługi Azure SQL Database, ponieważ zależy od funkcji niedostępnych w usłudze Azure SQL Database, CREATE EXTERNAL TABLE AS SELECT.	Narzędzie wiersza polecenia SqlPackage
Deployment	Dodano obsługę właściwości /p:IgnorePreDeployScript publikowania i /p:IgnorePostDeployScript. Te właściwości są domyślnie ustawione na false i po włączeniu powodują pominięcie odpowiednich skryptów w planie wdrożenia. Problem z usługą GitHub	SqlPackage CLI; DacFx API / porównywanie schematów
Permissions	Dodano obsługę uprawnień ALTER ANY EXTERNAL MIRROR dla usługi Azure SQL Database i bazy danych SQL Database w usłudze Microsoft Fabric. To uprawnienie jest wymagane do wyeksportowania bazy danych zawierającej co najmniej jedną tabelę dublowaną. Problem z usługą GitHub	CLI SqlPackage; Interfejs API DacFx / porównanie schematów
Permissions	Dodano obsługę uprawnień CREATE ANY EXTERNAL MODEL i ALTER ANY EXTERNAL MODEL programu SQL Server 2025 (17.x).	Interfejs wiersza polecenia SqlPackage; Interfejs API DacFx / porównanie schematów
Permissions	Dodano obsługę uprawnień ALTER ANY INFORMATION PROTECTION dla programu SQL Server 2025 (17.x) i usługi Azure SQL Database.	CLI SqlPackage; API DacFx / porównanie schematów
Platform	Pakiet SqlPackage .zip .NET SDK do kompilacji został zaktualizowany do wersji 8.0.412.	Platforma; Interfejs wiersza polecenia SqlPackage
ScriptDom	Zaktualizowano ScriptDom do wersji 170.0.64.	Platform
ScriptDom	Aktualizuje magazyn danych na platformie Fabric, aby używać TSqlFabricDWParser w ScriptDom.	Platformy; Interfejs API DacFx / porównanie schematów

Fixes

Feature	Details	Odnosi się do
Zawsze szyfrowane	Rozwiązano problem Interactive z opcją parametru publikowania /AzureKeyVaultAuthMethod, która nie działała poprawnie.	Narzędzie wiersza polecenia SqlPackage
Deployment	Rozwiązano problem, w którym DbScopedConfigMaxDOPSecondarywłaściwość nie została poprawnie ustawiona we wdrożeniu. Problem z usługą GitHub	CLI SqlPackage; API DacFx / porównanie schematów
Deployment	Rozwiązano problem powodujący, że publikowanie tabel zawierających ograniczenia klucza obcego kończyło się niepowodzeniem z powodu składni, która nie jest obsługiwana w magazynie danych w usłudze Microsoft Fabric.	Narzędzie wiersza polecenia SqlPackage
Deployment	Rozwiązano problem, w którym obiekty serwera były uwzględniane podczas wdrażania do bazy danych SQL w usłudze Microsoft Fabric. Obiekty serwera nie są obsługiwane w bazie danych SQL w usłudze Microsoft Fabric. Problem z usługą GitHub	Narzędzie wiersza polecenia SqlPackage
Deployment	Rozwiązano problem polegający na tym, że klastrowane indeksy magazynu kolumn są tworzone poprzez najpierw utworzenie indeksu klastrowanego, co zwiększa koszty obliczeniowe i czas wdrażania. Problem z usługą GitHub	Narzędzie wiersza polecenia SqlPackage
Extract	Rozwiązano problem polegający na tym, że wyodrębnianie bazy danych z bazy danych SQL w usłudze Microsoft Fabric powoduje niezdatne do użycia skrypty definicji użytkownika. Problem z usługą GitHub	Narzędzie wiersza polecenia SqlPackage

170.0.94 SqlPackage

Data wydania: 15 kwietnia 2025 r

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

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

Features

Feature	Details	Odnosi się do
DACPACVerify	Dodano obsługę weryfikowania zawartości dwóch .dacpac plików w narzędziu podglądu Microsoft.DacpacVerify.	Interfejs API DacFx / porównanie schematów
Extract	Dodano obsługę rozpakowywania .dacpac pliku do folderu. Polecenie /Action:Extract jest używane z parametrami /SourceFile: i /TargetFile: . Plik docelowy musi być folderem, a jeśli zostanie określony plik źródłowy (.dacpac), nie są prawidłowe żadne właściwości połączenia z bazą danych. Właściwość /p:ExtractTarget=SchemaObjectType jest wymagana do wyodrębniania z pliku, a nie ze źródłowej .dacpac bazy danych. Plik wykonywalny Dacunpack.exe jest usuwany z DacFx.msi instalatora.	CLI SqlPackage; API DacFx / porównanie schematów
Parquet	Dodano obsługę typów danych znacznik czasu, rowversion, uniqueidentifier, text, ntext, image, json, xml i vector podczas korzystania z plików Parquet w usłudze Azure Blob Storage za pomocą operacji wyodrębniania i publikowania SqlPackage.	Narzędzie wiersza polecenia SqlPackage
Parquet	Dodano obsługę eksportowania i importowania danych tabeli do plików BCP, gdy tabela zawiera nieobsługiwany typ danych podczas korzystania z plików Parquet w usłudze Azure Blob Storage dla pozostałych danych z operacjami wyodrębniania i publikowania sqlPackage. Przykładowy typ danych to sql_variant, a tabela zawierająca kolumnę tego typu jest zapisywana za pomocą BCP, .dacpac a pozostałe tabele są zapisywane w plikach Parquet w Azure Blob Storage.	Narzędzie wiersza polecenia SqlPackage
Platform	Zaktualizowano pakiet SqlPackage dla wersji .NET Framework do .NET Framework 4.7.2.	Platforma; Interfejs wiersza polecenia SqlPackage
Platform	Usunięto obsługę platformy .NET 6.	Platforma; Interfejs wiersza polecenia SqlPackage
ScriptDom	Zaktualizowano ScriptDom do wersji 170.18.0.	Platform
Projekty SQL	Domyślny poziom zgodności dla usługi Azure SQL Database i bazy danych SQL w usłudze Microsoft Fabric jest teraz ustawiony na 170. Aby uzyskać więcej informacji, zobacz Poziom zgodności bazy danych 170 w Azure SQL Database i SQL Database w Microsoft Fabric.	Projekty MSBuild/SQL
Vector	Typ danych wektorowych jest teraz obsługiwany na platformie docelowej na potrzeby Azure SQL Database importu, eksportu, wyodrębniania, wdrażania i kompilacji projektu SQL.	CLI SqlPackage; Projekty MSBuild/SQL; DacFx API / Porównanie schematów

Fixes

Feature	Details	Odnosi się do
Deployment	Rozwiązano problem polegający na tym, że wdrażanie zmiany w tabeli zewnętrznej powodowało, że wszystkie tabele zewnętrzne są porzucane i tworzone ponownie, jeśli zmodyfikowana tabela nie zawierała żadnych wartości dla REJECT_VALUE lub REJECT_SAMPLE_VALUE.	CLI SqlPackage; API DacFx / porównanie schematów
Deployment	Rozwiązano problem polegający na tym, że zmiana kolumny w celu rozszerzenia jej długości powoduje nieprawidłowe ostrzeżenie o utracie danych, jeśli sortowanie kolumny jest określone i jest zgodne z domyślnym sortowaniem bazy danych. Problem z usługą GitHub	CLI SqlPackage; API DacFx / porównanie schematów
Deployment	Rozwiązano problem polegający na tym, że zmiany klasyfikacji poufności w tabeli powodowały ponowne utworzenie indeksów. Problem z usługą GitHub	CLI SqlPackage; API DacFx / porównanie schematów
Export	Zoptymalizowano użycie szacowania rozmiaru tabeli podczas operacji eksportowania.	Narzędzie wiersza polecenia SqlPackage
Extract	Rozwiązano problem polegający na tym, że wyodrębnianie elementu .dacpac z odwołaniem do bazy danych kończyło się niepowodzeniem. Problem z usługą GitHub	CLI SqlPackage; API DacFx / porównanie schematów
Magazyn danych sieci szkieletowej	Rozwiązano problem, gdzie procedura składowana systemu sp_refreshsqlmodule była wywoływana podczas operacji publikowania. Magazyn danych Fabric nie obsługuje sp_refreshsqlmodule, co powoduje niepowodzenie wdrożenia.	Narzędzie wiersza polecenia SqlPackage
Magazyn danych sieci szkieletowej	Rozwiązano problem polegający na tym, że ograniczenia tabeli były uwzględniane w plikach .dacpac, ale nie .sql w przypadku wyodrębnienia bazy danych z Fabric Data Warehouse. Problem z usługą GitHub	Narzędzie wiersza polecenia SqlPackage
Projekty SQL	Rozwiązano problem polegający na tym, że kompilowanie bez programu SSDT zainstalowanego w programie Visual Studio powoduje nieprawidłowe zachowanie kompilacji. Problem z usługą GitHub	Projekty MSBuild/SQL
Projekty SQL	Rozwiązano problem polegający na tym, że ostrzeżenia kompilacji zostały zduplikowane w danych wyjściowych po włączeniu analizy kodu. Problem z usługą GitHub	Projekty MSBuild/SQL
Projekty SQL	Rozwiązano problem polegający na tym, że parametry brokera usług ustawione na zmienne powodowały fałszywe ostrzeżenia. Problem z usługą GitHub	Projekty MSBuild/SQL

Zarchiwizowane wersje (162.x i starsze wersje)

Informacje o wersji dla wersji 162.x i starszych można znaleźć w informacjach o wersji pakietu SqlPackage (archiwum).