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

Aplica-se a: SQL Server no Linux

As etapas a seguir instalam as ferramentas de linha de comando, os drivers ODBC da Microsoft e as dependências deles. 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 plataforma:

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

Importante

sqlcmd e bcp estão disponíveis em mssql-tools18 para x64 e arm64 arquiteturas. 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 ver versões anteriores, consulte Instalar o driver ODBC da Microsoft para SQL Server (Linux).

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

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

    • Para o Red Hat 10, use o comando a seguir para baixar o arquivo de configuração do repositório da Microsoft Red Hat do repositório RHEL 9. As mesmas versões de ferramentas também funcionam para o RHEL 10.

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

    • 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ê tiver uma versão anterior do mssql-tools instalada, remova 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 do desenvolvedor do 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/ à variável de ambiente PATH em um Shell Bash.

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

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

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

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

Instalar ferramentas no macOS

Instale o Homebrew se você ainda não o tiver:

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

Para instalar as ferramentas no 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 você executar o SQL Server em um contêiner do Docker, as ferramentas de linha de comando do SQL Server já serão incluídas na imagem de contêiner do Linux do SQL Server. Ao anexar a um contêiner em execução usando um shell Bash interativo, é possível executar as ferramentas localmente.

Se você estiver criando um contêiner com as ferramentas de linha de comando do SQL Server, é recomendável adicionar ACCEPT_EULA=Y ao comando de instalação para aceitar rapidamente os termos de licença e não interromper a criação da imagem. Um comando final de exemplo 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 o computador Linux não tiver acesso aos repositórios online usados nas seções anteriores, baixe os arquivos de pacote diretamente. Esses pacotes estão localizados no repositório da Microsoft, em https://packages.microsoft.com.

Dica

Se você realizar a instalação com sucesso com as etapas das seções anteriores, não precisará baixar nem instalar manualmente os pacotes a seguir. Isso vale apenas para o cenário offline.

  1. Primeiro, localize e copie o pacote mssql-tools18 para sua distribuição do Linux. No Red Hat 8.0, esse 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 msodbcsql18 também tem uma dependência em unixODBC-devel. No Red Hat, o pacote msodbcsql18 está localizado em https://packages.microsoft.com/rhel/8/prod.

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

  4. Instale os pacotes mssql-tools18 e msodbc18: Instale os pacotes mssql-tools18 e msodbc18. Se você obtiver 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, você pode ignorar esta etapa. Em alguns casos, você deve localizar essas dependências manualmente e instalá-las.

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

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

Conteúdo relacionado

Contribua com a documentação do SQL

Você sabia que pode editar conteúdo do SQL por conta própria? Ao fazer isso, além de melhorar nossa documentação, você também será creditado como um colaborador da página.

Para obter mais informações, consulte Editar a documentação do Microsoft Learn.

  • Last updated on