Поделиться через

Заметки о выпуске SqlPackage

Скачать последнюю версию

В этой статье перечислены возможности и исправления, предоставляемые выпущенными версиями SqlPackage.

Как прочитать эти заметки о выпуске

Область действия столбца Применяется к в разделе определяется следующим образом:

  • SqlPackage CLI — действия командной строки (публикация, импорт, экспорт, извлечение, Parquet, диагностика, средство dotnet)
  • MSBuild / SQL проекты — сборка SQL-проектов (Microsoft.Build.Sql SDK, интеграция SQL Server Data Tools (SSDT)
  • API DacFx / Сравнение схем - Microsoft.SqlServer.DacFx API NuGet, сравнение схем
  • Платформа — ScriptDom, Microsoft.Data.SqlClient, поддержка .NET, системные DACPACs, параметры совместимости по умолчанию

Текущие выпуски (170.x)

Следующие выпуски являются поддерживаемыми в настоящее время версиями SqlPackage.

170.3.93 SqlPackage

Дата выпуска: 10 февраля 2026 г.

dotnet tool install -g microsoft.sqlpackage --version 170.3.93
Platform Download
Windows .NET 10 файл.zip
Windows .msi файл
macOS .NET 10 файл.zip
Linux .NET 10 файл.zip

Features

Feature Details Применимо к
Deployment Добавлена поддержка параметров ACCELERATED_DATABASE_RECOVERY базы данных и OPTIMIZED_LOCKING. Интерфейс командной строки SqlPackage; Api DacFx / Сравнение схем
Permissions Улучшает публикацию разрешений для включения EXECUTE ON EXTERNAL MODEL разрешений. Интерфейс командной строки SqlPackage; API DacFx / Сравнение схем
Platform Добавлена поддержка .NET 10 в библиотеку DacFx и интерфейс командной строки SqlPackage. SqlPackage dotnet tool доступен как для .NET 8, так и для .NET 10. Платформа; Интерфейс командной строки SqlPackage; API DacFx / Сравнение схем
Platform Добавлена поддержка .NET Standard 2.0 в библиотеку DacFx. Платформа: API DacFx / Сравнение схем баз данных
Platform Ссылается на Microsoft.Data.SqlClient версии 6.1.3. Platform
ScriptDom Обновлен скриптDom до версии 170.157.0. Platform
Vector Расширяет поддержку векторных столбцов, чтобы разрешить изменение базового типа. Интерфейс командной строки SqlPackage; Проекты MSBuild / SQL; Api DacFx / Сравнение схем

Fixes

Feature Details Применимо к
Deployment Исправлена ошибка при развертывании в базу данных SQL в Microsoft Fabric, когда целевая база данных содержит политику безопасности. Интерфейс командной строки SqlPackage; Api DacFx / Сравнение схем
Export Исправлена проблема, из-за которой экспортированные файлы не проходят проверку схемы XSD из-за значений логических атрибутов, использующих True/False вместо значений в нижнем регистре true/false. Проблема, рассмотренная на сайте GitHub Интерфейс командной строки SqlPackage
Import Исправлена проблема, из-за которой импорт таблицы со специальными символами в имени (например, /, ", или $) терпит неудачу, не предупреждая пользователя о невозможности импорта данных. Проблема, рассмотренная на сайте GitHub Интерфейс командной строки SqlPackage
Ledger Исправлена проблема, из-за которой таблица реестра с вычисляемым столбцом вызывает NullReferenceException в процессе проверки модели и сборки. Проблема, рассмотренная на сайте GitHub Проекты MSBuild / SQL; Api DacFx / Сравнение схем
Проекты SQL Исправлена проблема, из-за которой создание проекта SQL со встроенным кластеризованным индексом по столбцам в таблице завершалось ошибкой синтаксиса. Проблема, рассмотренная на сайте GitHub Проекты MSBuild / SQL
Проекты SQL Исправлена проблема, из-за которой кластеризованный индекс columnstore в таблице с NVARCHAR(MAX) другими столбцами типа LOB неправильно сообщает об ошибке, что индексы columnstore не поддерживаются векторными столбцами. Проблема, рассмотренная на сайте GitHub Проекты MSBuild / SQL
Vector Исправлена проблема, из-за которой процедуры, использующие VECTOR_SEARCH, выдавали предупреждение проверки о невозможности разрешения ссылки на столбец. Проблема, рассмотренная на сайте GitHub Проекты MSBuild / SQL; Api DacFx / Сравнение схем

170.2.70 SqlPackage

Дата выпуска: 14 октября 2025 г.

dotnet tool install -g microsoft.sqlpackage --version 170.2.70
Platform Download
Windows .NET 8 файл.zip
Windows .msi файл
macOS .NET 8 файл.zip
Linux .NET 8 файл.zip

Features

Feature Details Применимо к
Внешние модели Добавлена поддержка внешних моделей в Базе данных SQL Azure и SQL Server 2025 (17.x) для импорта, экспорта, извлечения, развертывания и сборки проекта SQL. Интерфейс командной строки SqlPackage; Проекты MSBuild / SQL; Api DacFx / Сравнение схем
Внешние модели Добавлена поддержка функций AI_GENERATE_CHUNKS и AI_GENERATE_EMBEDDINGS. Интерфейс командной строки SqlPackage; Api DacFx / Сравнение схем
JSON Добавлена поддержка индексов JSON в Базе данных SQL Azure и SQL Server 2025 (17.x) для импорта, экспорта, извлечения, развертывания и сборки проекта SQL. Интерфейс командной строки SqlPackage; проекты MSBuild / SQL; API DacFx / сравнение схем
JSON Добавлена поддержка функций JSON JSON_ARRAYAGG, JSON_OBJECTAGG, и JSON_QUERY. Интерфейс командной строки SqlPackage; Проекты MSBuild / SQL; Api DacFx / Сравнение схем
Platform Пакет SDK сборки .NET для SqlPackage .zip обновляется до версии 8.0.414 Платформа; интерфейс командной строки SqlPackage
Regex Добавлена поддержка REGEXP_LIKE функции. Интерфейс командной строки SqlPackage; проекты MSBuild / SQL; API DacFx / сравнение схем
ScriptDom Обновлена версия ScriptDom до версии 170.128.0. Platform
Vector Добавлена поддержка векторных индексов в Базе данных SQL Azure и SQL Server 2025 (17.x) для импорта, экспорта, извлечения, развертывания и сборки проекта SQL. Интерфейс командной строки SqlPackage; Проекты MSBuild / SQL; API DacFx / Сравнение схем
Vector Расширяет поддержку типа векторных данных в SQL Server 2025 (17.x) и задает 32-разрядный размер с плавающей запятой. Интерфейс командной строки SqlPackage; Проекты MSBuild / SQL; API DacFx / Сравнение схем
Vector Добавлена поддержка функции Vector VECTOR_SEARCH. Интерфейс командной строки SqlPackage; Проекты MSBuild / SQL; Api DacFx / Сравнение схем

Fixes

Feature Details Применимо к
Маскирование данных Исправлена проблема, из-за которой функции маскирования данных datetime не были распознаны во время сборки проекта. Проблема, рассмотренная на сайте GitHub Проекты MSBuild / SQL
Внешние модели Исправлена проблема, из-за которой внешние зависимости модели от учетных данных в области базы данных привели к сбою сборки проекта. Проекты MSBuild / SQL
JSON Исправлена ошибка при сравнении индексов JSON с путем JSON по умолчанию. API DacFx и сравнение схем; Интерфейс командной строки SqlPackage
Platform Ссылается на Microsoft.Data.SqlClient версии 5.1.7 . Platform
XML Исправлена проблема, из-за которой путь запроса XML (xQuery) не рассматривался как регистр при сравнении моделей. Даже в базах данных, не учитывающих регистр, путь xQuery учитывает регистр. Проблема, рассмотренная на сайте GitHub API DacFx и сравнение схем; Интерфейс командной строки SqlPackage

170.1.61 SqlPackage

Дата выпуска: 30 июля 2025 г.

dotnet tool install -g microsoft.sqlpackage --version 170.1.61
Platform Download
Windows .NET 8 файл.zip
Windows .msi файл
macOS .NET 8 файл.zip
Linux .NET 8 файл.zip

Features

Feature Details Применимо к
Виртуализация данных Добавлена поддержка объектов, связанных с виртуализацией данных для базы данных SQL Azure, в операциях импорта, экспорта, извлечения и публикации. Интерфейс командной строки SqlPackage
Виртуализация данных Добавлена база данных SQL Azure в публикацию с предварительным просмотром файлов parquet, что позволяет использовать хранилище BLOB-объектов Azure и файлы parquet для импорта данных в базу данных. Извлечение данных в файлы parquet недоступно для базы данных SQL Azure, так как она зависит от функциональных возможностей, недоступных в Базе данных SQL Azure. CREATE EXTERNAL TABLE AS SELECT Интерфейс командной строки SqlPackage
Deployment Добавлена поддержка публикационных свойств /p:IgnorePreDeployScript и /p:IgnorePostDeployScript. Эти свойства имеют значение по умолчанию false, и при включении результат в том, что план развертывания пропускает соответствующие скрипты. Проблема, рассмотренная на сайте GitHub Интерфейс командной строки SqlPackage; Api DacFx / Сравнение схем
Permissions Добавлена поддержка разрешения ALTER ANY EXTERNAL MIRROR для базы данных SQL Azure и базы данных SQL в Microsoft Fabric. Это разрешение необходимо для экспорта базы данных, содержащей одну или несколько зеркальных таблиц. Проблема, рассмотренная на сайте GitHub Интерфейс командной строки SqlPackage; Api DacFx / Сравнение схем
Permissions Добавлена поддержка разрешений CREATE ANY EXTERNAL MODEL и ALTER ANY EXTERNAL MODEL для SQL Server 2025 (17.x). Интерфейс командной строки SqlPackage; Api DacFx / Сравнение схем
Permissions Добавлена поддержка разрешений ALTER ANY INFORMATION PROTECTION для SQL Server 2025 (17.x) и Базы данных SQL Azure. Интерфейс командной строки SqlPackage, API DacFx, Сравнение схем
Platform Пакет SDK сборки .NET для SqlPackage .zip обновляется до версии 8.0.412. Платформа; Интерфейс командной строки SqlPackage
ScriptDom Обновлено ScriptDom до версии 170.0.64. Platform
ScriptDom Обновляет хранилище данных на платформе Fabric для использования TSqlFabricDWParser в ScriptDom. Платформа; API DacFx / Сравнение схем

Fixes

Feature Details Применимо к
Всегда зашифровано Исправлена проблема, из-за которой параметр публикации Interactive с опцией /AzureKeyVaultAuthMethod не работал правильно. Интерфейс командной строки SqlPackage
Deployment Исправлена проблема, из-за которой DbScopedConfigMaxDOPSecondaryсвойство не было задано правильно в развертывании. Проблема, рассмотренная на сайте GitHub Интерфейс командной строки SqlPackage; DacFx API / Сравнение схем
Deployment Исправлена проблема, из-за которой не удаётся публиковать таблицы с ограничениями внешнего ключа из-за неподдерживаемого синтаксиса в хранилище данных Microsoft Fabric. Интерфейс командной строки SqlPackage
Deployment Исправлена проблема, из-за которой объекты сервера были включены при развертывании в базе данных SQL в Microsoft Fabric. Объекты сервера не поддерживаются в базе данных SQL в Microsoft Fabric. Проблема, рассмотренная на сайте GitHub Интерфейс командной строки SqlPackage
Deployment Исправлена проблема, из-за которой кластеризованные индексы columnstore создаются при первом создании кластеризованного индекса, что увеличивает затраты на развертывание и время. Проблема, рассмотренная на сайте GitHub Интерфейс командной строки SqlPackage
Extract Исправлена проблема, из-за которой извлечение базы данных из базы данных SQL в Microsoft Fabric приводит к неиспользуемым сценариям определения пользователей. Проблема, рассмотренная на сайте GitHub Интерфейс командной строки SqlPackage

170.0.94 SqlPackage

Дата выхода: 15 апреля, 2025

dotnet tool install -g microsoft.sqlpackage --version 170.0.94
Platform Download
Windows .NET 8 файл.zip
Windows .msi файл
macOS .NET 8 файл.zip
Linux .NET 8 файл.zip

Features

Feature Details Применимо к
DACPACVerify Добавлена поддержка проверки содержимого двух .dacpac файлов в средстве предварительного просмотра Microsoft.DacpacVerify. API DacFx / Сравнение схем
Extract Добавлена поддержка распаковки .dacpac файла в папку. Команда /Action:Extract используется с параметрами /SourceFile: и /TargetFile:. Целевой файл должен быть папкой, и если указан исходный файл (.dacpac), никакие свойства подключения к базе данных не действительны. Свойство /p:ExtractTarget=SchemaObjectType требуется для извлечения из файла .dacpac вместо исходной базы данных. Исполняемый файл Dacunpack.exe удаляется из установщика DacFx.msi. Интерфейс командной строки SqlPackage; DacFx API / Сравнение схем
Parquet Добавлена поддержка типов данных timestamp, rowversion, uniqueidentifier, text, ntext, image, json, xml и vector при использовании файлов Parquet в Azure Blob Storage с операциями извлечения и публикации SqlPackage. Интерфейс командной строки SqlPackage
Parquet Добавлена поддержка экспорта и импорта данных таблицы в файлы BCP, когда таблица содержит неподдерживаемый тип данных, при использовании файлов Parquet в Azure Blob Storage для остальных данных с помощью операций извлечения и публикации с SqlPackage. Пример типа данных — sql_variant, а таблица, содержащая столбец этого типа, записывается в BCP в то время как остальные таблицы записываются в .dacpac файлы Parquet в хранилище BLOB-объектов Azure. Интерфейс командной строки SqlPackage
Platform Версия SqlPackage для .NET Framework обновлена до .NET Framework 4.7.2. Платформа; Интерфейс командной строки SqlPackage
Platform Удалена поддержка .NET 6. Платформа; Интерфейс командной строки SqlPackage
ScriptDom Обновлен ScriptDom до версии 170.18.0. Platform
Проекты SQL Уровень совместимости по умолчанию для базы данных SQL Azure и базы данных SQL в Microsoft Fabric теперь имеет значение 170. Дополнительные сведения см. в статьях Уровень совместимости баз данных 170 в Базе данных SQL Azure и База данных SQL в Microsoft Fabric. Проекты MSBuild / SQL
Vector Векторный тип данных теперь поддерживается на целевой платформе Azure SQL Database для импорта, экспорта, извлечения, развертывания и сборки проекта SQL. Интерфейс командной строки SqlPackage; Проекты MSBuild / SQL; Api DacFx / Сравнение схем

Fixes

Feature Details Применимо к
Deployment Исправлена проблема, из-за которой при развертывании изменения во внешней таблице все внешние таблицы были удалены и повторно созданы, если измененная таблица не содержала значений REJECT_VALUE или REJECT_SAMPLE_VALUE. Интерфейс командной строки SqlPackage; DacFx API / Сравнение схем
Deployment Исправлена проблема, из-за которой изменение столбца для расширения длины приводит к неправильному предупреждению о потере данных, если задана сортировка столбца и соответствует параметрам сортировки базы данных по умолчанию. Проблема, рассмотренная на сайте GitHub Интерфейс командной строки SqlPackage; DacFx API / Сравнение схем
Deployment Исправлена проблема, из-за которой изменения классификации конфиденциальности в таблице вызывают повторное создание индексов. Проблема, рассмотренная на сайте GitHub Интерфейс командной строки SqlPackage; DacFx API / Сравнение схем
Export Оптимизировано использование оценки размера таблицы во время операций экспорта. Интерфейс командной строки SqlPackage
Extract Исправлена ошибка, приводившая к сбою при извлечении ссылки .dacpac из базы данных. Проблема, рассмотренная на сайте GitHub Интерфейс командной строки SqlPackage; DacFx API / Сравнение схем
Хранилище данных Fabric Исправлена проблема, из-за которой sp_refreshsqlmodule системная хранимая процедура вызывается во время операции публикации. Хранилище данных Fabric не поддерживается sp_refreshsqlmodule , и это приводит к сбою развертывания. Интерфейс командной строки SqlPackage
Хранилище данных Fabric Исправлена проблема, из-за которой ограничения таблиц включаются в файлы .dacpac, но не в файлы .sql, когда база данных была извлечена из хранилища данных Fabric. Проблема, рассмотренная на сайте GitHub Интерфейс командной строки SqlPackage
Проекты SQL Исправлена проблема, из-за которой сборка без SSDT, установленного в Visual Studio, приводит к неправильному поведению сборки. Проблема, рассмотренная на сайте GitHub Проекты MSBuild / SQL
Проекты SQL Исправлена проблема, из-за которой предупреждения сборки дублируются в выходных данных при включении анализа кода. Проблема, рассмотренная на сайте GitHub Проекты MSBuild / SQL
Проекты SQL Исправлена проблема, из-за которой параметры компонента Service Broker , заданные для переменных, приводят к ложным предупреждениям. Проблема, рассмотренная на сайте GitHub Проекты MSBuild / SQL

Архивные выпуски (162.x и более ранние версии)

Заметки о выпуске для версий 162.x и более ранних версий можно найти в заметках о выпуске sqlPackage (архив).

  • Last updated on