Partilhar via

Instalar as ferramentas de linha de comando sqlcmd e bcp do SQL Server no Linux

  • Artigo

Aplica-se a:SQL Server - Linux

As etapas a seguir instalam as ferramentas de linha de comando, drivers ODBC da Microsoft e suas dependências. O pacote mssql-tools contém:

  • sqlcmd: Utilitário de consulta de linha de comando.
  • bcp: Utilitário de importação e exportação em massa.

Instale as ferramentas para a sua plataforma:

Este artigo descreve como instalar as ferramentas de linha de comando. Se estiver procurando exemplos de como usar sqlcmd ou bcp, consulte o conteúdo relacionado no final deste artigo.

Importante

sqlcmd e bcp estão disponíveis em mssql-tools18 para arquiteturas x64 e arm64. Para obter uma alternativa moderna no Linux, macOS e Windows, consulte utilitário go-sqlcmd.

Instalar ferramentas no Linux

Estas instruções são para instalar os pacotes do Microsoft ODBC 18. Para versões anteriores, consulte Instalar o driver ODBC da Microsoft para SQL Server (Linux).

Use as etapas a seguir para instalar o mssql-tools18 no Red Hat Enterprise Linux.

  1. Baixe o arquivo de configuração do repositório Microsoft Red Hat.

    • Para o Red Hat 9, use o seguinte comando:

      curl https://packages.microsoft.com/config/rhel/9/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo

    • Para o Red Hat 8, use o seguinte comando:

      curl https://packages.microsoft.com/config/rhel/8/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo

    • Para o Red Hat 7, use o seguinte comando:

      curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo

  2. Se você tinha uma versão anterior do mssql-tools instalada, remova todos os pacotes unixODBC mais antigos.

    sudo yum remove mssql-tools unixODBC-utf16 unixODBC-utf16-devel

  3. Execute os seguintes comandos para instalar mssql-tools18 com o pacote de desenvolvedor unixODBC.

    sudo yum install -y mssql-tools18 unixODBC-devel

    Para atualizar para a versão mais recente do mssql-tools, execute os seguintes comandos:

    sudo yum check-update
sudo yum update mssql-tools18

  4. Opcional: Adicione /opt/mssql-tools18/bin/ à sua variável de ambiente PATH em uma shell bash.

    Para tornar sqlcmd e bcp acessíveis a partir do shell bash para sessões de login, modifique o seu PATH no arquivo ~/.bash_profile usando o seguinte comando:

    echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bash_profile
source ~/.bash_profile

    Para tornar sqlcmd e bcp acessíveis a partir do shell bash para sessões interativas/não login, modifique o PATH no arquivo ~/.bashrc com o seguinte comando:

    echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc

Instalar ferramentas no macOS

Instale Homebrew se ainda não o tiver:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Para instalar as ferramentas para macOS El Capitan e versões posteriores, use os seguintes comandos:

# brew untap microsoft/mssql-preview if you installed the preview version
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
brew install mssql-tools18

Instalar ferramentas no Docker

Se executar o SQL Server num contentor Docker, as ferramentas de linha de comando do SQL Server já estão incluídas na imagem do contentor do SQL Server Linux. Se você anexar a um contêiner em execução com um shell bash interativo, poderá executar as ferramentas localmente.

Se você estiver criando um contêiner com as ferramentas de linha de comando do SQL Server, deverá adicioná-ACCEPT_EULA=Y ao comando de instalação para aceitar silenciosamente o EULA e não interromper a criação de imagens. Um exemplo de comando final como parte da instalação em uma imagem baseada no Ubuntu é:

sudo ACCEPT_EULA=Y apt-get install mssql-tools18 unixodbc-dev

Instalação offline

Se sua máquina Linux não tem acesso aos repositórios on-line usados nas seções anteriores, você pode baixar os arquivos do pacote diretamente. Esses pacotes estão localizados no repositório da Microsoft em https://packages.microsoft.com.

Dica

Se você instalou com êxito com as etapas nas seções anteriores, não é necessário baixar ou instalar manualmente os seguintes pacotes. Isso é apenas para o cenário offline.

  1. Primeiro, localize e copie o pacote de mssql-tools18 para sua distribuição Linux. Para o Red Hat 8.0, este pacote está localizado em https://packages.microsoft.com/rhel/8/prod.

  2. Além disso, localize e copie o pacote msodbcsql18, que é uma dependência. O pacote de msodbcsql18 também tem uma dependência de unixODBC-devel. Para a Red Hat, o pacote msodbcsql18 está localizado em https://packages.microsoft.com/rhel/8/prod.

  3. Mova os pacotes baixados para sua máquina Linux. Se você usou uma máquina diferente para baixar os pacotes, uma maneira de mover os pacotes para sua máquina Linux é com o comando scp.

  4. Instalar o e pacotes: Instale o mssql-tools18 e pacotes de msodbc18. Se você receber erros de dependência, ignore-os até a próxima etapa. Substitua <version> pela versão correta:

    sudo yum localinstall msodbcsql18-<version>.rpm
sudo yum localinstall mssql-tools18-<version>.rpm

  5. Resolver dependências ausentes: Você pode ter dependências ausentes neste momento. Caso contrário, pode ignorar este passo. Em alguns casos, você deve localizar e instalar manualmente essas dependências.

    Você pode inspecionar as dependências necessárias utilizando os seguintes comandos. Substitua <version> pela versão correta:

    rpm -qpR msodbcsql18-<version>.rpm
rpm -qpR mssql-tools18-<version>.rpm

Conteúdo relacionado

Contribuir para a documentação SQL

Você sabia que você mesmo pode editar conteúdo SQL? Se o fizer, não só ajudará a melhorar a nossa documentação, como também será creditado como contribuidor da página.

Para obter mais informações, consulte Como contribuir para a documentação do SQL Server