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

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

  • Статья

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

  • Номер версии: 162.5.57
  • Номер сборки: 162.5.57.1
  • Дата выпуска: 21 ноября 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 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

Устранение неполадок при установке

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

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

    dotnet --list-sdks

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

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

    dotnet nuget list source

    Если 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:

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

Добавление пакета 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:
Китайский (упрощенное письмо) | Китайский (традиционное письмо) | Английский (США) | Французский | Немецкий | Итальянский | Японский | Корейский | Португальский (Бразилия) | Русский | Испанский

Связанное содержимое