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 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 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 logon, modifique o PATH no arquivo ~/.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.

Tip

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. Resolvendo 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 o 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 a documentação Edit Microsoft Learn.

  • Last updated on