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

  • Статья

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

  • Номер версии: 162.2.111
  • Номер сборки: 162.2.111.2
  • Дата выпуска: 27 февраля 2024 г.

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

Примечание.

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

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

Установка SqlPackage в качестве средства dotnet требует установки пакета SDK для .NET на компьютере. Установка SqlPackage в качестве глобального средства делает его доступным на вашем пути, как sqlpackage и рекомендуется установить SqlPackage для Windows, macOS и Linux. SqlPackage доступен в качестве средства dotnet для .NET 6 и .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 доступны в веб-канале инструментов 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 не требуется, однако зависимости, включенные в эту .zip скачивания, обновляются чаще в параметре средства dotnet для SqlPackage. Следующие ссылки предназначены для последней версии SqlPackage:

Платформа Загрузка
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

    Примечание.

    Могут отсутствовать зависимости. Чтобы установить эти зависимости с учетом вашей версии 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

    Примечание.

    Возможно, для запуска 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\160\DAC\bin.

Удаление SqlPackage

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

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

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

Последние версии sqlpackage можно скачать по обновляемым ссылкам:

DacFx

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

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

dotnet add package Microsoft.SqlServer.DacFx

Примечание.

Были опубликованы дополнительные пакеты NuGet с именем DacFx: "Microsoft.SqlServer.DacFx.x64" и "Microsoft.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 v12 SP2+
  • Ubuntu 20.04+

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

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

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

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

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

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

Next Steps

Заявление о конфиденциальности корпорации Майкрософт