Baixar e instalar o SqlPackage

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: 170.2.70
• Número de build: 170.2.70.1
• Data de lançamento: 14 de outubro de 2025

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.

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 8 e versões posteriores.

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

Instalar o SqlPackage com o .NET 9 ou posterior

Para instalar o SqlPackage com uma versão mais recente do SDK do .NET, adicione --allow-roll-forward ao comando de instalação:

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

Essa opção permite que o SqlPackage use uma versão mais recente do runtime do .NET se o .NET 8 não estiver instalado.

Solucionar problemas de instalação

Se você encontrar problemas durante a instalação, siga estas etapas:

1. Verifique se o SDK do .NET está instalado: verifique se o SDK do .NET está instalado no computador executando o seguinte comando:

   dotnet --list-sdks
   

   Se o SDK do .NET não estiver listado, baixe-o e instale-o na página de download do SDK do .NET .

2. Verifique a configuração de origem do NuGet: o SqlPackage foi publicado nuget.orgem um feed NuGet público. Você pode encontrar um erro indicando que microsoft.sqlpackage não pode ser encontrado:

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

   Verifique se nuget.org está configurada como origem do NuGet para dotnet. Liste as fontes do NuGet configuradas executando:

   dotnet nuget list source
   

   Esse comando deve exibir uma lista de fontes do NuGet. Procure nuget.org na saída, que normalmente está listada como https://api.nuget.org/v3/index.json. Se nuget.org não estiver listado, adicione-o como uma fonte NuGet usando o seguinte comando:

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

3. Repetir instalação: após verificar a instalação do SDK do .NET e a configuração de origem do NuGet, tente reinstalar o SqlPackage usando o comando apropriado:

   dotnet tool install -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. Não é necessário instalar o .NET; no entanto, os requisitos do sistema operacional são os mesmos que para instalar a ferramenta dotnet . As dependências incluídas neste download .zip são atualizadas com mais frequência na opção de ferramenta dotnet para SqlPackage. Os links apresentados a seguir são para a última versão do SqlPackage:

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
   

   Note

   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
   

   Note

   As configurações de segurança podem exigir modificação 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\170\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:

• Linux (https://aka.ms/sqlpackage-linux)
• macOS (https://aka.ms/sqlpackage-macos)
• Windows (https://aka.ms/sqlpackage-windows)
• Windows .NET Framework (https://aka.ms/dacfx-msi)

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

Sistemas operacionais compatíveis

A execução do utilitário SqlPackage pode ocorrer no Windows, no macOS e no Linux. Ele é desenvolvido usando .NET 8. Os requisitos do sistema operacional .NET 8 correspondem aos requisitos mínimos para o SqlPackage, que tem requisitos extras devido às suas 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

Conteúdo relacionado

• SqlPackage
• SqlPackage em pipelines de desenvolvimento
• solução de problemas com SqlPackage
• O que são projetos de banco de dados SQL?
• Repositório do GitHub do DacFx
• Política de privacidade da Microsoft