Бөлісу құралы:

Скачивание и установка SqlPackage

SqlPackage выполняется в Windows, macOS и Linux и доступен для установки через dotnet tool или как автономный zip-архив. См. подробности в заметках о выпуске.

  • Номер версии: 170.2.70
  • Номер сборки: 170.2.70.1
  • Дата выпуска: 14 октября 2025 г.

SqlPackage разрабатывается и выпускается как для .NET 8, так и для платформа .NET Framework. Установка версии .NET 8 SqlPackage рекомендуется с помощью удобного dotnet tool метода, который является кроссплатформенным и простым для обновления или с помощью переносимого автономного .zip скачивания. В релизах .NET 8 SqlPackage реализованы преимущества постоянного прогресса в области производительности и масштабируемости .NET в рамках основного направления на современные приложения, что отличает их от поддержки обслуживания в рамках платформы .NET Framework для Windows. Версия платформы .NET Framework доступна только в качестве установщика .msi Windows.

Note

Ранее SqlPackage имел отдельный номер версии (19) и номер сборки (160.x). Начиная с версии 161 номер версии SqlPackage соответствует номеру версии DacFx, с которым он связан (например, 162.0.52).

Установка, кроссплатформенная

Установка SqlPackage как инструмента dotnet требует, чтобы SDK для .NET был установлен на вашем компьютере. Установка SqlPackage в качестве глобального средства делает его доступным в вашем PATH (как sqlpackage) и это рекомендуемый метод установки SqlPackage для Windows, macOS и Linux. SqlPackage доступен как средство dotnet для .NET 8 и более поздних версий.

Чтобы установить SqlPackage в качестве глобального средства .NET, выполните следующую команду:

dotnet tool install -g microsoft.sqlpackage

Дополнительные сведения о параметрах, доступных с dotnet tool install помощью команды, см. в документации по установке средства dotnet.

Чтобы обновить SqlPackage до последней версии, выполните следующую команду:

dotnet tool update -g microsoft.sqlpackage

Чтобы удалить SqlPackage, выполните следующую команду:

dotnet tool uninstall -g microsoft.sqlpackage

Установка SqlPackage с помощью .NET 9 или более поздней версии

Чтобы установить SqlPackage с более новой версией пакета SDK для .NET, добавьте --allow-roll-forward в команду установки:

dotnet tool install -g microsoft.sqlpackage --allow-roll-forward

Этот параметр позволяет SqlPackage использовать более новую версию среды выполнения .NET, если .NET 8 не установлена.

Устранение неполадок, связанных с установкой

Если во время установки возникли проблемы, выполните следующие действия.

  1. убедитесь, что пакет SDK для .NET установлен: убедитесь, что пакет SDK для .NET установлен на компьютере, выполнив следующую команду:

    dotnet --list-sdks

    Если пакет SDK для .NET не указан, скачайте и установите его со страницы загрузки для пакета SDK для .NET.

  2. Проверьте конфигурацию источника NuGet: SqlPackage публикуется в nuget.orgобщедоступном веб-канале NuGet. Может возникнуть ошибка, указывающая, что microsoft.sqlpackage не удается найти:

    microsoft.sqlpackage is not found in NuGet feeds C:\Program Files(x86)\Microsoft SDKs\NuGetPackages\

    Убедитесь, что nuget.org это настроенный источник NuGet для dotnet. Перечислить настроенные источники NuGet, выполнив следующую команду:

    dotnet nuget list source

    Эта команда должна отобразить список источников NuGet. Ищите nuget.org в выходных данных, которые обычно обозначаются как https://api.nuget.org/v3/index.json. Если nuget.org не указан, добавьте его в качестве источника NuGet с помощью следующей команды:

    dotnet nuget add source https://api.nuget.org/v3/index.json

  3. повторная установка: после проверки установки пакета SDK для .NET и конфигурации источника NuGet повторите установку SqlPackage с помощью соответствующей команды:

    dotnet tool install -g microsoft.sqlpackage

Предварительные версии выпусков

Предварительные выпуски SQLPackage доступны в ленте инструментов dotnet. Чтобы получить доступ к предварительным выпускам, используйте параметр --prerelease команду dotnet tool. Например, чтобы установить последнюю предварительную версию, выполните следующую команду:

dotnet tool install -g --prerelease microsoft.sqlpackage

Чтобы обновить SqlPackage до последней предварительной версии, выполните следующую команду:

dotnet tool update -g --prerelease microsoft.sqlpackage

Список предварительных выпусков доступен в канале инструментов dotnet для SqlPackage.

Установка, скачивание файлов (альтернатива)

SqlPackage также подготавливается как автономное скачивание для Windows, macOS и Linux. Однако установка .NET не требуется, требования к операционной системе совпадают с установкой средства dotnet. Зависимости, включенные в загрузку .zip, обновляются чаще в параметрах инструмента dotnet для SqlPackage. Следующие ссылки предназначены для последней версии SqlPackage:

Platform Download
Windows .NET 8 файл.zip
Windows .msi файл
macOS .NET 8 файл.zip
Linux .NET 8 файл.zip

Linux

  1. Скачивание SqlPackage для Linux

  2. Извлеките файл и запустите SqlPackage. Откройте новое окно терминала и введите следующие команды:

    cd ~
mkdir sqlpackage
unzip ~/Downloads/sqlpackage-linux-<version string>.zip -d ~/sqlpackage
echo "export PATH=\"\$PATH:$HOME/sqlpackage\"" >> ~/.bashrc
chmod a+x ~/sqlpackage/sqlpackage
source ~/.bashrc
sqlpackage

    Note

    Возможно, у вас отсутствуют зависимости. Чтобы установить эти зависимости с учетом вашей версии Linux, используйте следующие команды:

    Debian:

    sudo apt-get install libunwind8

    Red Hat:

    yum install libunwind
yum install libicu

    Ubuntu:

    sudo apt-get install libunwind8

macOS

  1. Скачивание SqlPackage для macOS

  2. Извлеките файл и запустите SqlPackage. Откройте новое окно терминала и введите следующие команды:

    mkdir sqlpackage
unzip ~/Downloads/sqlpackage-osx-<version string>.zip -d ~/sqlpackage
chmod +x ~/sqlpackage/sqlpackage
echo 'export PATH="$PATH:~/sqlpackage"' >> ~/.bash_profile
source ~/.bash_profile
sqlpackage

    Note

    Для запуска SqlPackage в macOS может потребоваться изменение параметров безопасности. Используйте следующие команды для взаимодействия с Gatekeeper из командной строки.

    Перед выполнением SqlPackage:

    sudo spctl --master-disable

    После выполнения SqlPackage:

    sudo spctl --master-enable

Windows (.NET 8)

  1. Скачивание SqlPackage для Windows

  2. Извлеките файл, щелкнув правой кнопкой мыши файл в проводнике Windows и выбрав команду "Извлечь все..." и выберите целевой каталог.

  3. Откройте окно терминала и перейдите в ту папку, куда только что извлекли содержимое SqlPackage.

    > sqlpackage

Windows (.NET Framework)

Этот выпуск SqlPackage включает стандартные средства установщика Windows и ZIP-файл:

  1. Скачивание и запуск установщика DacFramework.msi для Windows
  2. Откройте новое окно командной строки и запустите SqlPackage
    • Программа SqlPackage устанавливается в папку C:\Program Files\Microsoft SQL Server\170\DAC\bin.

Удалите SqlPackage

Если вы установили SqlPackage с помощью установщика Windows, удаление выполняется так же, как и для любого приложения Windows.

Если вы установили SqlPackage с помощью ZIP-файла или другого архива, удалите файлы.

Автоматизированные среды

Ссылки Evergreen доступны для скачивания последних версий SqlPackage:

DacFx

SqlPackage — это интерфейс командной строки для платформы DacFx, который предоставляет некоторые общедоступные API DacFx. DacServices (Microsoft.SqlServer.Dac) — это связанный механизм для интеграции развертывания базы данных в конвейер приложений. API-интерфейс DacServices доступен в пакете NuGet Microsoft.SqlServer.DAcFx.

Добавление пакета NuGet в проект .NET выполняется с помощью интерфейса командной строки .NET с помощью следующей команды:

dotnet add package Microsoft.SqlServer.DacFx

Note

Другие пакеты NuGet были опубликованы под именем DacFx и Microsoft.SqlServer.DacFx.x64Microsoft.SqlServer.DacFx.x86. Поддержка обоих платформ рассматривается в пакете Microsoft.SqlServer.DacFx . Новые указания должны быть на этот пакет, а не на варианты x64 или x86.

Поддерживаемые операционные системы

SqlPackage работает в Windows, macOS и Linux и создается с помощью .NET 8. Требования к ОС .NET 8 являются минимальными требованиями для SqlPackage, что имеет дополнительные требования из-за зависимостей.

Windows (x64)

  • Windows 11
  • Windows 10 (1607+)
  • Windows Server Core 2012 R2+
  • Windows Server 2012 R2+

macOS

  • macOS 12 "Монтери"+

Linux (x64)

  • Debian 11+
  • Red Hat Enterprise Linux 8+
  • SUSE Linux Enterprise Server версии 12 с пакетом обновления 2 (SP2) и более поздних версий
  • Ubuntu 20.04+

Доступные языки

Этот выпуск SqlPackage можно установить для следующих языков:

SqlPackage .NET 8 Windows:
Китайский (упрощенное письмо) | Китайский (традиционное письмо) | Английский (США) | Французский | Немецкий | Итальянский | Японский | Корейский | Португальский (Бразилия) | Русский | Испанский

SqlPackage платформа .NET Framework Windows:
Китайский (упрощенное письмо) | Китайский (традиционное письмо) | Английский (США) | Французский | Немецкий | Итальянский | Японский | Корейский | Португальский (Бразилия) | Русский | Испанский

SqlPackage .NET 8 macOS:
Китайский (упрощенное письмо) | Китайский (традиционное письмо) | Английский (США) | Французский | Немецкий | Итальянский | Японский | Корейский | Португальский (Бразилия) | Русский | Испанский

SqlPackage .NET 8 Linux:
Китайский (упрощенное письмо) | Китайский (традиционное письмо) | Английский (США) | Французский | Немецкий | Итальянский | Японский | Корейский | Португальский (Бразилия) | Русский | Испанский

Связанный контент

  • Last updated on