Baixar e instalar o SqlPackage

  • Artigo

O SqlPackage é executado no Windows, macOS e Linux e está disponível para instalação por meio do dotnet tool ou como um download compactado autônomo. Para obter detalhes sobre a versão mais recente, confira as notas sobre a versão.

  • Número de versão: 162.2.111
  • Número de build: 162.2.111.2
  • Data de lançamento: 27 de fevereiro de 2024

O utilitário SqlPackage foi desenvolvido e liberado para .NET 8 e .NET Framework. A recomendação para a instalação da versão do SqlPackage para .NET 8 é feita por meio do método dotnet tool conveniente, que é multiplataforma e fácil de atualizar, ou por meio do download do arquivo em .zip portátil e independente. As liberações do SqlPackage para .NET 8 se beneficiam dos avanços contínuos no desempenho e na escalabilidade do .NET como parte do foco em aplicativos modernos, o que contrasta com o suporte de manutenção do .NET Framework para Windows. A versão para .NET Framework está disponível somente como um instalador do Windows no formato .msi.

Observação

Anteriormente, o SqlPackage tinha um número de versão distinto (19) e um número de build (160.x). A partir da versão 161, o número de versão do SqlPackage corresponde ao número de versão do DacFx ao qual ele está associado (por exemplo, 162.0.52).

Instalação, multiplataforma

A instalação do SqlPackage como uma ferramenta dotnet requer que o SDK do .NET esteja instalado em seu computador. Instalar o SqlPackage como uma ferramenta global faz com que ele esteja disponível em seu caminho como sqlpackage e é o método recomendado para instalar o SqlPackage para Windows, macOS e Linux. O SqlPackage está disponível como uma ferramenta dotnet para .NET 6 e .NET 8.

Para instalar o SqlPackage como uma ferramenta global do .NET, execute o seguinte comando:

dotnet tool install -g microsoft.sqlpackage

Mais informações sobre as opções disponíveis com o comando dotnet tool install podem ser encontradas na documentação de instalação da ferramenta dotnet.

Para atualizar o SqlPackage para a última versão, execute o seguinte comando:

dotnet tool update -g microsoft.sqlpackage

Para desinstalar o SqlPackage, execute o seguinte comando:

dotnet tool uninstall -g microsoft.sqlpackage

Versões prévias

As liberações da visualização prévia do SqlPackage estão disponíveis com o feed da ferramenta dotnet. Para acessar liberações da visualização prévia, use a opção --prerelease com o comando dotnet tool. Por exemplo, para instalar a versão de visualização mais recente, execute o seguinte comando:

dotnet tool install -g --prerelease microsoft.sqlpackage

Para atualizar o SqlPackage para a última versão prévia, execute o seguinte comando:

dotnet tool update -g --prerelease microsoft.sqlpackage

Uma lista de versões prévias está disponível no feed da ferramenta dotnet para SqlPackage.

Instalação e download de arquivos (alternativa)

O SqlPackage também está preparado como um download independente para Windows, macOS e Linux. Nenhuma instalação do .NET é necessária, no entanto, as dependências incluídas neste download em .zip são atualizadas com mais frequência na opção da ferramenta dotnet para SqlPackage. Os links apresentados a seguir são para a última versão do SqlPackage:

Plataforma Baixar
Windows .NET 8 arquivo zip
Windows Arquivo .msi
macOS .NET 8 arquivo zip
Linux .NET 8 arquivo zip

Linux

  1. Faça o download do SqlPackage para Linux.

  2. Extraia o arquivo e inicie o SqlPackage, abra uma nova janela do Terminal e digite os seguintes comandos:

    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

    Observação

    Você pode ter dependências ausentes. Use os seguintes comandos para instalar estas dependências, de acordo com sua versão do Linux:

    Debian:

    sudo apt-get install libunwind8

    Red Hat:

    yum install libunwind
yum install libicu

    Ubuntu:

    sudo apt-get install libunwind8

macOS

  1. Faça download do SqlPackage para macOS.

  2. Extraia o arquivo e inicie o SqlPackage, abra uma nova janela do Terminal e digite os seguintes comandos:

    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

    Observação

    As configurações de segurança podem exigir modificações para executar o SqlPackage no macOS. Use os comandos a seguir para interagir com o Gatekeeper usando a linha de comando.

    Antes de executar o SqlPackage:

    sudo spctl --master-disable

    Depois de executar o SqlPackage:

    sudo spctl --master-enable

Windows (.NET 8)

  1. Faça download do SqlPackage para Windows.

  2. Extraia o arquivo ao clicar com o botão direito do mouse no arquivo no Finder, ao selecionar “Extrair tudo...”, e, em seguida, selecione o diretório de destino.

  3. Abra uma nova janela de Terminal e CD para a localização em que o SqlPackage foi extraído:

    > sqlpackage

Windows (.NET Framework)

Esta versão do SqlPackage inclui uma experiência padrão do Windows Installer e um .zip:

  1. Faça download e execute o instalador DacFramework.msi para Windows.
  2. Abra uma nova janela do prompt de comando e execute SqlPackage
    • O SqlPackage é instalado na pasta C:\Program Files\Microsoft SQL Server\160\DAC\bin

Desinstalar o SqlPackage

Se você instalou o SqlPackage usando o Windows Installer, desinstale-o da mesma forma que você remove aplicativos do Windows.

Se você instalou o SqlPackage com um arquivo .zip ou outros arquivos, exclua os arquivos.

Ambientes automatizados

Os links do Evergreen estão disponíveis para baixar as versões mais recentes do Sqlpackage:

DacFx

O SqlPackage é uma interface de linha de comando para a estrutura DacFx, que expõe algumas das APIs públicas do DacFx. O DacServices (Microsoft.SqlServer.Dac) é um mecanismo relacionado para integrar a implantação de banco de dados no seu pipeline de aplicativo. A API do DacServices está disponível em um pacote por meio do NuGet, Microsoft.SqlServer.DacFx.

A adição do pacote NuGet a um projeto .NET é realizada por meio da CLI do .NET com este comando:

dotnet add package Microsoft.SqlServer.DacFx

Observação

Pacotes NuGet adicionais foram publicados com o nome DacFx, "Microsoft.SqlServer.DacFx.x64" e "Microsoft.SqlServer.DacFx.x86". O suporte para ambas as plataformas é abordado no pacote "Microsoft.SqlServer.DacFx". Novas referências devem ser feitas neste pacote e não nas variantes x64 ou x86.

Sistemas operacionais com suporte

A execução do utilitário SqlPackage pode ocorrer no Windows, no macOS e no Linux. Ele é desenvolvido usando .NET 8. Os requisitos do SO para .NET 8 correspondem aos requisitos mínimos para o SqlPackage, que tem requisitos adicionais devido às dependências.

Windows (x64)

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

macOS

  • macOS 12 “Monterey”+

Linux (x64)

  • Debian 11+
  • Red Hat Enterprise Linux 8+
  • SUSE Linux Enterprise Server v12 SP2+
  • Ubuntu 20.04+

Idiomas disponíveis

Esta versão do SqlPackage pode ser instalada nos seguintes idiomas:

SqlPackage .NET 8 no Windows:
Chinês (Simplificado) | Chinês (Tradicional) | Inglês (Estados Unidos) | Francês | Alemão | Italiano | Japonês | Coreano | Português (Brasil) | Russo | Espanhol

SqlPackage .NET Framework no Windows:
Chinês (Simplificado) | Chinês (Tradicional) | Inglês (Estados Unidos) | Francês | Alemão | Italiano | Japonês | Coreano | Português (Brasil) | Russo | Espanhol

SqlPackage .NET 8 no macOS:
Chinês (Simplificado) | Chinês (Tradicional) | Inglês (Estados Unidos) | Francês | Alemão | Italiano | Japonês | Coreano | Português (Brasil) | Russo | Espanhol

SqlPackage .NET 8 no Linux:
Chinês (Simplificado) | Chinês (Tradicional) | Inglês (Estados Unidos) | Francês | Alemão | Italiano | Japonês | Coreano | Português (Brasil) | Russo | Espanhol

Próximas etapas

Política de Privacidade da Microsoft