Partilhar via

Baixe e instale o SqlPackage

  • Artigo

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

  • Número da versão: 162.5.57
  • Número de compilação: 162.5.57.1
  • Data de lançamento: 21 de novembro de 2024

SqlPackage é desenvolvido e lançado para .NET 8 e .NET Framework. A instalação da versão .NET 8 SqlPackage é recomendada através do método conveniente dotnet tool, que é multiplataforma e fácil de atualizar, ou através do portátil autônomo .zip download. As versões do .NET 8 SqlPackage beneficiam-se das melhorias contínuas no desempenho e na escalabilidade do .NET, como parte do foco nos aplicativos modernos, o que contrasta com o suporte de manutenção do .NET Framework para Windows. A versão do .NET Framework só está disponível como um instalador Windows .msi.

Observação

Anteriormente, SqlPackage tinha um número de versão distinto (19) e número de compilação (160.x). A partir da versão 161, o número da versão do SqlPackage corresponde ao número de versão do DacFx ao qual 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 seja instalado na sua máquina. A instalação do SqlPackage como uma ferramenta global o torna disponível em seu caminho como sqlpackage e é o método recomendado para instalar o SqlPackage para Windows, macOS e Linux. SqlPackage está disponível como uma ferramenta dotnet para .NET 8 e versões posteriores.

Para instalar o SqlPackage como uma ferramenta .NET global, 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 SqlPackage para a versão mais recente, execute o seguinte comando:

dotnet tool update -g microsoft.sqlpackage

Para desinstalar o SqlPackage, execute o seguinte comando:

dotnet tool uninstall -g microsoft.sqlpackage

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 em sua máquina executando o seguinte comando:

    dotnet --list-sdks

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

  2. Verificar a configuração de origem do NuGet: Verifique se nuget.org é uma fonte NuGet configurada para dotnet. Liste as fontes NuGet configuradas executando o comando:

    dotnet nuget list source

    Se nuget.org não estiver listado, adicione-o como uma fonte do NuGet usando o seguinte comando:

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

  3. Reinstalar: Depois de verificar a instalação do SDK do .NET e a configuração da origem de NuGet, tente instalar novamente o SqlPackage usando o comando apropriado:

    dotnet tool install -g microsoft.sqlpackage

Versões de pré-visualização

As versões de pré-lançamento do SqlPackage estão disponíveis com o feed de ferramentas .NET. Para acessar versões de visualização, 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 SqlPackage para a versão de visualização mais recente, execute o seguinte comando:

dotnet tool update -g --prerelease microsoft.sqlpackage

Uma lista de versões de visualização está disponível no feed de ferramentas dotnet para SqlPackage.

Instalação, download de arquivos (alternativa)

O SqlPackage também é preparado como um download independente para Windows, macOS e Linux. Nenhuma instalação do .NET é necessária, no entanto, os requisitos do sistema operacional são os mesmos que a instalação da ferramenta dotnet . As dependências incluídas neste download .zip são atualizadas com mais freqüência na opção de ferramenta dotnet para SqlPackage. Os links a seguir são para a versão mais recente do SqlPackage:

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

Linux

  1. Descarregar SqlPackage for 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 essas dependências, dependendo da 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. Baixar 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ção para executar o SqlPackage no macOS. Use os comandos a seguir para interagir com o Gatekeeper a partir da linha de comando.

    Antes de executar SqlPackage:

    sudo spctl --master-disable

    Depois de executar SqlPackage:

    sudo spctl --master-enable

Windows (.NET 8)

  1. Baixar SqlPackage para Windows

  2. Extraia o arquivo clicando com o botão direito do mouse no arquivo no Windows Explorer, selecionando 'Extrair tudo...', e selecione o diretório de destino

  3. Abra uma nova janela do Terminal e cd para o local onde o SqlPackage foi extraído:

    > sqlpackage

Windows (.NET Framework)

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

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

Desinstalar SqlPackage

Se você instalou o SqlPackage usando o instalador do Windows, desinstale da mesma forma que remove qualquer aplicativo do Windows.

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

Ambientes automatizados

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

DacFx

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

Adicionar o pacote NuGet a um projeto .NET é realizado por meio da CLI do .NET com este comando:

dotnet add package Microsoft.SqlServer.DacFx

Observação

Pacotes NuGet adicionais foram publicados sob o nome DacFx, "Microsoft.SqlServer.DacFx.x64" e "Microsoft.SqlServer.DacFx.x86". O suporte para ambas as plataformas é coberto pelo pacote "Microsoft.SqlServer.DacFx". Novas referências devem ser feitas a este pacote, não às variantes x64 ou x86.

Sistemas Operativos Suportados

SqlPackage é executado em Windows, macOS e Linux e é construído usando .NET 8. Os requisitos do sistema operacional .NET 8 são requisitos mínimos para 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+

Línguas disponíveis

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

SqlPackage .NET 8 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 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 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 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